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* 讲 起 ， 一 直 延 伸 至 其 高 级 特性 ， 详 尽 
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了 模块 系统 的 


构建 和 和 运行 模块 化 应 用 程序 。 本 书 还 会 帮助 你 将 现 有 项 目 迁 移 到 Java 9 及 以 
上 版 本 ， 并 逐步 将 之 模块 化 。 书 中 主要 内 容 包 括 : 从 源 代码 到 JAR 来 构建 模块 、 迁 移 到 模块 化 Java、 解 
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难道 这 样 不 算 完 满 ? 
所 有 部 分 都 如 他 所 愿 。 
一 一 致 Gabi1， 致 Maia 
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模块 化 的 动机 与 愿望 并 非 刚刚 出 现 。1968 年 的 北约 软件 工程 大 会 是 一 次 具有 里 程 碑 意 义 的 
会 议 ， 对 推广 软件 组 件 和 软件 工程 这 一 术语 起 到 了 至 关 重 要 的 作用 。 在 会 议 记录 中 ,，E. E. David 
概述 了 开发 大 型 系统 的 方法 : 


定义 足够 小 、 易 于 管理 的 子 系统 ， 并 基于 子 系 统 进行 构建 。 此 策略 要 求 将 系统 设计 
为 模块 ， 除 了 模块 间 通 信 的 约定 外 ， 子 系统 可 以 独立 实现 、 测 试 和 修改 。 


在 同一 次 会 议 中 ，H. R. Gillette 描述 了 模块 化 如 何 支 持 系 统 的 演进 : 


模块 化 有 助 于 隔离 系统 的 功能 单元 。 要 对 一 个 模块 进行 调试 、 改 进 或 者 扩展 , 仅 需 
要 最 低 限 度 的 人 员 交 互 或 系统 停 转 。 


这 些 不 是 什么 新 概念 ， 经 过 一 段 时 间 的 编程 实践 就 能 掌握 其 中 的 技巧 。 

Java 模块 化 在 时 间 和 空间 上 像 拼 图 一 样 散 落 在 Java 历史 的 各 个 角落 。 类 是 Java 第 一 个 也 是 
最 基本 的 模块 实现 。 在 其 他 语言 中 , 类 表示 模块 化 和 类 型 的 统一 ， 为 类 型 及 其 操作 和 细节 提供 了 
一 些 隐 私 和 内 聚 性 。Java 则 更 进一步 ， 将 源 代码 中 的 类 结构 映射 到 二 进 制 组 件 。 

那么 ， 小 到 何 种 地 步 才 算 易于 管理 ? 类 太 小 了 ， 很 难 作为 这 个 问题 的 答案 。 

对 于 任何 代码 库 而 言 ,类 都 不 是 理想 的 大 规模 组 件 模 型 ,除非 代码 量 非常 小 或 者 类 的 实现 非 
党 糟糕 。 

此 外 ， 包 ( package ) 原本 的 正确 含义 为 : 打 好 封印 且 不 可 拆 分 的 实体 。 但 是 ，Java 错误 地 
将 其 实现 为 : 通过 命名 空间 将 代码 组 织 成 目录 结构 、 不 能 有 效 隔离 的 开放 式 布局 、 因 曾经 流行 而 
草率 制定 却 不 切实 际 的 域名 命名 法 。 

这 正巧 对 应 了 潘多拉 的 神话 。 希腊 神话 中 , 具有 一 切 天 赋 的 潘多拉 打开 了 释放 出 人 世间 所 有 
收 恶 的 盒子 。 其 实 这 是 误 传 , 潘多拉 打开 的 是 罐子 (jar ) 而 不 是 盒子 (box )。 她 打开 的 是 一 个 pithos 
( 色 子 )， 但 被 误 译 为 了 pyxis ( 盒子 ) “在 代码 中 情况 是 一 样 的 : 命名 很 重要 。 

JAR 是 组 件 模 型 的 关键 , 但 除了 将 类 文件 压缩 在 一 起 之 外 , 它 并 没有 提供 其 他 帮助 。 为 了 应 
对 由 此 产生 的 “JAR 地 狱 ” 问 题 ， 许 多 方法 (构建 工具 、0OSGi 捆绑 包 ) 扩展 了 JAR 模 型， 方便 
人 们 更 好 地 利用 模块 化 。 



















































































GD pithos 是 古 希 腊 的 一 种 陶 钠 ， 而 pyxis 在 拉丁 文中 是 盒子 之 意 。 一 一 编者 注 
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但 这 一 切 都 是 过 去 式 了 。 现 在 怎么 办 ?未 来 怎么 办 ? 

答案 就 在 面前 。 这 就 是 你 阅读 本 书 的 原因 。 

Java9 通过 模块 系统 将 零散 的 拼图 拼凑 到 了 一 起 , 模块 系统 成 了 Java 平 台 的 核心 而 不 是 扩展 
功能 。Java 的 模块 系统 必须 有 所 妥协 。 它 不 仅 要 保持 对 大 量 现 有 代码 的 支持 ,使 其 不 至 于 破坏 现 
有 的 生态 系统 ， 还 要 为 不 断 变化 的 世界 中 尚 待 编写 的 代码 提供 一 些 有 意义 的 帮助 。 

从 技术 层面 来 说 ， 你 需要 理解 模块 和 依赖 的 本 质 ， 以 及 语法 和 组 件 化 的 细节 ; 从 设计 角度 
来 说 , 你 需要 了 解 使 用 模块 所 带 来 的 好 处 与 坏处 。 像 任何 概念 或 观点 一 样 ,模块 化 不 可 以 随便 地 
加 入 到 项 目 之 中 , 采用 模块 化 需要 更 多 的 技术 和 思考 。 现 有 代码 在 更 加 模块 化 的 世界 中 会 有 什么 
样 的 改变 ? 模块 化 会 如 何 影响 部 署 和 开发 ? 你 需要 知道 这 些 问 题 以 及 你 所 探索 问题 的 答案 。 

这 些 问题 就 是 你 阅读 本 书 的 原因 。 

本 书 作者 会 逐一 解答 这 些 问 题 。 自 模块 出 现 后 , 他 就 一 直 关 注 着 。 他 深入 研究 JSR 和 相关 实 
现 ， 了 解 你 不 想 也 不 必 了 解 的 细节 。 他 对 细节 的 把 握 会 让 你 从 他 的 知识 中 得 到 升华 一 一 从 原理 到 
实践 ， 从 入 门 到 高 级 。 

本 书 是 一 份 很 好 的 礼物 。 请 翻 开 它 ， 阅 读 它 ， 享 受 它 吧 。 




































































——Kevlin Henney, Curbralan 有 限 公 司 
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2015 年 4 月 的 一 个 清晨 , 我 和 模块 系统 不 期 而 遇 。 上 班 之 前 , 我 检查 了 OpenJFX 邮件 列表 ， 
看 到 一 封 来 自 JavaFX 用 户 的 邮件 ， 该 用 户 担心 模块 化 的 限制 会 导致 私有 API 不 再 可 用 。 我 当时 
的 想法 是 : 这 绝 不 可 能 ，Java 绝 不 会 引入 不 兼容 的 变更 。 我 认为 这 是 误解 ， 然 后 便 去 上 班 了 。 

午饭 后 , 我 和 一 位 同事 讨论 了 此 问题 , 但 我 们 意见 不 同 。 因 为 讨论 没有 结果 ， 所 以 我 有 些 失 
望 , 决定 早点 回 家 去 享受 阳光 明媚 的 春日 。 我 在 阳台 上 喝 着 清凉 的 啤酒 ， 想 着 应 该 读 些 什么 。 读 
什么 呢 ?” 出 于 好 奇 ， 我 开始 阅读 对 早上 那 封 邮件 的 回复 ， 并 沉醉 在 其 中 1 

接 下 来 的 几 周 里 ， 我 津津 有 味 地 阅读 了 所 有 关于 Jigsaw 项 目的 信息 ， 这 是 一 个 开发 模块 系 
统 的 项 目 。 事 实证 明 ，JavaFX 用 户 的 担忧 是 对 的 。 

起 初 , 我 主要 关注 Java9 可 能 引入 的 不 兼容 问题 ， 其 潜在 的 优势 则 不 那么 明显 。 幸 好 ， 当 时 
我 正在 参与 一 个 大 型 Java 应 用 程序 的 相关 工作 。 在 工作 中 ， 我 慢 慢 地 意识 到 如 何 使 用 模块 系统 
来 改善 和 维护 项 目的 整体 结构 。 随 着 了 解 的 细节 越 来 越 多 ， 几 周 后 , 我 认同 了 将 模块 引入 生态 系 
统 的 想法 ， 即 使 这 意味 着 需要 打破 一 些 东西 。 

一 般 的 探索 旅程 会 先 从 兼容 性 问题 开始 , 然后 再 到 理解 模块 系统 及 其 所 带 来 的 优势 , 但 这 并 
不 是 唯一 的 路 径 ! 与 其 担心 现 有 的 代码 库 ， 你 可 能 更 想 评估 模块 系统 对 新 Java 项 目的 影响 ,或 
者 更 感 兴趣 于 模块 化 对 生态 系统 的 巨大 影响 。 无 论 从 何 处 开始 探索 ， 本 书 都 是 你 的 向 导 。 

如 果 你 想 知 道 旅程 将 走向 何方 ， 那 就 回想 一 下 Java 8。 它 引入 了 lambda 表达 式 ， 但 比 语言 
特性 更 重要 的 是 对 社区 和 生态 系统 的 持续 影响 : 它 向 数 百 万 Java 开发 人 员 介绍 了 函数 式 编程 的 
基础 知识 ,引入 了 全 新 概念 并 拓展 了 我 们 的 视野 ， 使 我 们 成 为 更 优秀 的 开发 人 员 。 它 不 仅 为 许多 
新 的 库 提 供 了 灵感 ， 还 促进 了 现 有 框架 的 改进 。 

思考 模块 系统 时 请 牢记 一 点 : 它 不 仅 是 一 种 新 的 语言 特性 , 还 将 引导 我 们 更 多 地 了 解 各 种 形 
式 的 模块 化 ,以 及 如 何 正 确 地 设计 和 维护 大 型 软件 项 目 ,， 并 促使 我 们 通过 库 、 框 架 和 工具 更 好 地 
支持 模块 化 。 它 将 使 我 们 成 为 更 优秀 的 开发 人 员 。 
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Giancarlo Massari、 Guido Pio Mariotti、Ivan Milosavljevié 、James Wright、Jeremy Bryan、Kathleen 
Estrada、Maria Gemini、Mark Dechamps、Mikkel Arentoft、Rambabu Posa、Sebastian Czech、Shobha 
Iyer、Steve Dawsonn-Andoh 、Tatiana Fesenko 、Tomasz Borek 和 Tony Sweets。 感 谢 你 们 所 有 人 ! 

还 要 感谢 社区 和 Oracle 公司 所 有 参与 了 模块 系统 开发 的 人 ,不 单单 是 因为 他 们 努力 工作 而 让 
我 有 机 会 为 之 写作 ， 同 时 也 因为 他 们 高 质量 的 文档 和 精彩 的 演讲 让 我 如 此 兴奋 。 特 别 感谢 Mark 
Reinhold、Alex Buckley 和 Alan Bateman。 他 们 是 这 个 项 目的 先锋 ， 并 且 回 答 了 我 在 Jigsaw 项 目 
邮件 列表 中 提出 的 大 量 问 题 。 谢 谢 你 们 1! 

有 些 人 也 许 不 曾 料 到 我 的 感谢 : Robert Kriiger 可 能 还 不 知道 ， 是 他 2015 年 4 月 8 日 那 封 重 
要 的 邮件 激发 了 我 对 模块 系统 的 兴趣 ; 在 与 Jigsaw 项 目 相遇 的 第 一 个 下 午 ， 我 就 和 Christian 
Gl6kler 展开 了 激烈 的 讨论 ; Boris Terzic 总 是 鼓励 我 深入 研究 ( 让 我 在 工作 中 探索 Java 的 新 版 本 )。 
还 有 2018 年 所 有 为 我 提供 反馈 的 人 ， 你 们 的 鼓励 给 了 我 很 大 动力 ， 谢 谢 你 们 ! 

致 我 所 有 的 朋友 : 尽管 我 总 是 很 忙 , 但 你 们 始终 陪伴 在 我 身 旁 , 感谢 你 们 在 我 低谷 期 给 予 的 
鼓励 。 致 我 的 家 人 : 我 一 直 努 力 不 让 本 书 的 写作 影响 我 们 宝贵 的 团聚 时 间 , 感谢 你 们 在 我 做 不 到 
的 时 候 总 是 宽容 我 。 你 们 一 贯 的 耐心 、 爱 和 支持 使 本 书 得 以 出 版 。 是 你 们 成 就 了 我 ， 我 爱 你 们 1! 




















































































































关于 本 书 


Java9 将 Java 平台 模 块 系统 (JPMS ) 引入 到 Java 语 言及 其 生态 系统 中 ， 从 此 所 有 Java 开发 
者 都 可 以 使 用 模块 化 原 语 。 对 于 包括 我 自己 在 内 的 大 多 数 人 而 言 ， 这些 是 全 新 的 概念 ， 所 以 本 书 
会 从 头 讲 起 一 一 从 设计 动机 和 基本 概念 一 直 讲 到 高 级 特性 ， 以 帮助 大 家 了 解 Java 模块 系统 。 除 
此 之 外 ,本 书 还 会 帮助 你 将 现 有 项 目 迁 移 到 Java 9 及 以 上 版 本 ， 并 逐步 将 之 模块 化 。 

需要 注意 的 是 ， 本 书 不 会 专门 讲解 模块 化 程序 的 设计 理念 。 这 是 一 个 复杂 的 话题 ,并且 市 面 
上 已 经 有 很 多 关于 模块 化 的 书 了 ， 如 Kirk Knoernschild 所 著 的 《Java 应 用 架构 设计 : 模块 化 模式 
与 OSGi》。 但 是 随 着 我 们 在 模块 系统 中 实现 模块 化 ， 你 一 定 会 了 解 模块 化 的 概念 与 背景 。 

请 从 这 里 开始 你 的 旅程 。 


本 书 读者 


模块 系统 是 一 个 非常 有 意思 的 话题 。 它 的 基本 原理 和 概念 都 很 简单 ， 但 是 对 整个 Java 生态 
系统 的 影响 很 深远 。 模 块 系统 不 像 lambda 表达 式 那 样 可 以 让 人 立即 兴奋 起 来 ,但 是 可 以 像 它 那 
样 彻底 改变 整个 Java 生态 系统 。 到 目前 为 止 ， 模 块 系统 已 经 像 编 译 需 、private 访问 修饰 符 、 
if 条 件 语句 一 样 成 了 Java 的 一 部 分 。 每 个 开发 者 都 需要 了 解 这些 Java 概念 ， 同样， 他 们 也 需要 
了 解 模块 系统 。 

值得 庆幸 的 是 ,模块 系统 的 人 门 很 简单 .模块 系统 的 核心 只 有 几 个 简单 的 概念 ,任何 具备 Java 
基础 知识 的 开发 者 都 可 以 理解 。 如 果 你 知道 访问 修饰 符 的 工作 原理 ,粗略 地 了 解 如 何 使 用 javac、 
jar 和 java， 并 且 知 道 JVM 怎样 从 JAR 文件 中 加 载 类 ， 那么 基本 上 就 满足 入 门 条 件 了 。 

如 果 你 就 是 这 样 一 位 开发 者 ， 并且 喜欢 接受 挑战 ,那么 我 鼓励 你 阅读 本 书 。 你 不 一 定 能 马上 
融会 贯通 ， 但 能 够 深入 理解 模块 系统 ， 并 进一步 理解 Java 生态 系统 。 

另 一 方面 ， 对 模块 系统 的 融会 贯通 ， 需 要 有 两 三 年 的 Java 项 目 开发 经 验 。 一 般 而 言 ， 你 做 
过 的 项 目 越 大 ,在 架构 演进 、 依 赖 选择 ， 以 及 解决 错误 依赖 带 来 的 问题 等 方面 参与 得 越 深 ,你 就 
越 会 感激 模块 系统 带 来 的 好 处 。 同 时 ， 这 也 有 助 于 你 广泛 地 审视 模块 系统 对 已 有 项 目 以 及 Java 
生态 系统 的 影响 。 































































































X 关于 本 书 


本 书 的 组 织 方式 : 路 线 图 


本 书 的 结构 有 几 个 层次 。 所 有 章节 划分 为 3 个 部 分 , 但 你 不 必 按 顺序 阅读 。 我 会 按照 你 的 需 
求 来 建议 不 同 的 阅读 范围 和 阅读 顺序 。 








章节 
本 书 共 15 章 ， 分 为 3 个 部 分 。 
第 一 部 分 展示 了 模块 系统 要 改善 的 Java 的 不 足 之 处 ， 并 解释 了 模块 系统 的 基本 机 制 ， 以 及 
如 何 创 建 、 构 建 和 运行 模块 化 应 用 程序 。 
口 第 1 章 指出 了 Java 在 JAR 层面 缺乏 对 模块 化 的 支持 ， 讨 论 了 该 缺陷 的 负面 影响 以 及 模块 
系统 如 何 处 理 这 些 缺 陷 。 
口 第 2 章 展示 了 如 何 构建 和 运行 一 个 模块 化 应 用 程序 ， 并 且 介 绍 了 贯穿 本 书 的 应 用 程序 示 
例 。 这 一 章 展示 的 是 模块 系统 的 全 景 ， 不 会 探寻 细节 一 一 这 是 后 面 3 章 要 做 的 事情 。 
口 第 3 章 介 绍 了 作为 基本 构建 单元 的 模块 声明 ， 以 及 模块 系统 如 何 处 理 模 块 声明 以 实现 它 
最 重要 的 目标 : 让 项 目 更 加 可 靠 、 更 容易 维护 。 
口 第 4 章 展示 了 如 何 利 用 javac 和 jar 命令 编译 和 打包 一 个 模块 化 项 目 。 
口 第 5 章 讲述 了 java 命令 的 一 些 新 选项 。 启 动 一 个 模块 化 应 用 程序 很 简单 , 因此 这 一 章 主 
要 展示 发 现 并 解决 问题 所 需要 的 工具 。 
第 二 部 分 抛 开 了 完全 模块 化 的 理想 项 目 ， 演 示 了 如 何 将 现 有 项 目 迁 移 到 Java 9 及 以 上 版 本 ， 
并 且 逐 步 将 之 模块 化 。 
口 第 6 章 探寻 了 将 现 有 代码 迁移 到 Java 9 时 人 们 普遍 会 遇 到 的 障碍 ( 尚未 涉及 任何 模块 创 
建 。 
口 第 7 章 讨 论 了 两 个 额外 的 难题 。 单 独 讨 论 是 因为 它们 不 局 限于 迁移 ， 在 对 项 目 完成 迁移 
和 模块 化 后 ， 你 很 可 能 依然 会 遇 到 它们 。 
口 第 8 章 展示 了 如 何 对 运行 于 Java 9 上 的 大 型 项 目 进行 模块 化 改造 。 好 消息 是 ， 你 没 必要 
一 次 性 完成 这 个 工作 。 
口 第 9 章 总 结 了 前 面 3 章 的 内 容 ， 帮 助人 们 制定 迁移 和 模块 化 现 有 代码 的 策略 。 
第 三 部 分 展示 了 构建 于 第 一 部 分 所 介绍 的 基本 概念 之 上 的 高 级 特性 。 
口 第 10 章 讲述 了 模块 系统 如 何 对 API 的 提供 者 和 使 用 者 进行 隔离 。 
口 第 11 章 扩 展 了 第 3 章 介绍 的 基本 依赖 和 访问 机 制 ， 为 实现 现实 世界 中 的 复杂 场景 提供 了 
灵活 性 。 
口 第 12 章 讨 论 了 反射 是 如 何 被 拉 下 神 坛 的 ， 开 发 者 需要 什么 样 的 应 用 程序 、 库 和 框架 以 使 
反射 代码 工作 ， 以 及 一 些 新 的 扩展 反射 API 的 强力 特性 。 
口 第 13 章 解 释 了 为 什么 模块 系统 通常 会 忽略 版 本 信息 、 它 对 版 本 的 有 限 支持 ， 以 及 运行 同 
一 个 模块 的 多 个 版 本 的 可 行 性 一 一 尽管 这 很 复杂 ,但 的 确 可 行 。 
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口 第 14 童 利用 所 需 的 模块 创建 自己 的 运行 时 镜像 , 展示 了 如 何 从 模块 化 JDK 中 受益 ,也 通 
过 将 模块 化 应 用 程序 打包 到 镜像 中 并 制作 单一 的 部 署 单元 ， 展 示 了 如 何 从 模块 化 应 用 程 
序 中 受益 。 

口 第 15 章 利用 第 三 部 分 的 所 有 花哨 功能 ， 展 示 了 第 2 章 所 介绍 的 应 用 程序 的 全 貌 ， 并 且 为 
如 何 更 好 地 利用 模块 系统 提供 了 建议 。 
































选择 适合 的 阅读 路 径 


我 希望 本 书 不 只 是 一 本 讲授 模块 系统 的 教材 ， 仅 被 从 头 到 尾 读 一 遍 。 当 然 ， 这 并 没有 什么 问 
题 , 但 是 我 希望 它 能 为 你 带 来 更 多 帮助 。 希 望 你 可 以 按照 感 兴趣 的 顺序 来 学 习 最 关心 的 内 容 , 把 
它 作为 一 本 指导 手册 放 在 书桌 上 ， 随 时 查阅 细节 。 

从 头 到 尾 读 完 本 书 当然 很 好 , 但 是 并 非 一 定 要 这 么 做 。 我 会 确保 每 种 机 制 或 特性 自 成 一 章 或 
一 节 ， 它 的 所 有 细节 都 可 以 在 其 中 找到 。 

为 了 便于 你 单独 阅读 各 章 , 我 会 时 常 重复 表述 或 引用 一 些 在 本 书 其 他 部 分 介绍 的 内 容 , 这 样 
你 在 没有 读 到 那些 内 容 时 仍然 可 以 注意 到 它们 。 如果 你 在 阅读 过 程 中 感到 我 重复 讲解 或 者 做 了 太 
多 提示 ， 请 原谅 我 。 

如 果 你 不 想 从 头 到 尾 阅 读本 书 ， 那 么 几 条 阅读 路 径 可 供 你 选择 。 

我 只 有 两 个 小 时 ， 请 向 我 展示 最 值得 阅读 的 部 分 
口 “模块 系统 的 目标 ”，1.6 节 
口 “ 模 块 化 应 用 程序 剖析 ”， 第 2 章 
口 “ 定 义 模块 及 其 属性 ”， 第 3 章 
口 “模块 化 应 用 程序 小 贴 士 ”，15.2 节 
我 想 将 已 有 项 目 迁 移 到 Java 9 
口 “第 一 块 拼图 ”"， 第 1 章 
口 “定义 模块 及 其 属性 ”"， 第 3 章 
口 “迁移 到 Java 9 及 以 上 版 本 的 兼容 性 挑战 "， 第 6 章 
口 “在 Java 9 及 以 上 版 本 上 运行 应 用 程序 时 会 反复 出 现 的 挑战 ”， 
口 “无 名 模块 ”，8.2 节 
口 “迁移 策略 ”，9.1 节 
我 想 用 模块 系统 构建 一 个 新 项 目 
口 “ 你 好 ， 模块"， 第 一 部 分 
口 “用 服务 来 解 耦 模块 >， 第 10 章 
口 “完善 依赖 关系 和 API ， 第 11 章 
口 “完成 拼图 "， 第 15 章 
模块 系统 是 如 何 改变 Java 生态 系统 的 
口 “ 第 一 块 拼图 ”, 第 1 章 
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口 “模块 化 应 用 程序 剖析 ”， 第 2 章 
口 “ 定 义 模块 及 其 属性 ”， 第 3 章 
口 略 读 “迁移 到 Java 9 及 以 上 版 本 的 兼容 性 挑战 ”, 第 6 章 ;“ 在 Java9 及 以 上 版 本 上 运行 应 
用 程序 时 会 反复 出 现 的 挑战 ?>， 第 7 章 
口 “模块 系统 高 级 特性 ”， 第 三 部 分 (可 以 略 过 第 10 章 和 第 11 章 ) 
我 应 邀 参加 一 个 聚会 ， 需 要 知道 模块 系统 的 一 些 奇 闻 异 事 以 便 有 话 可 说 
“ 鸟 梧 模块 系统 ”，1.4 节 
“模块 系统 的 目标 ”，1.6 节 
“组 织 项 目的 目录 结构 ”，4.1 节 
“从 模块 中 加 载 资 源 "”，5.2 节 
“调试 模块 及 模块 化 应 用 程序 ”，5.3 节 
“迁移 到 Java 9 及 以 上 版 本 的 兼容 性 挑战 ”, 第 6 章 ;“ 在 Java9 及 以 上 版 本 上 运行 应 用 程 
序 时 会 反复 出 现 的 挑战 "， 第 7 章 的 内 容 是 个 不 错 的 话题 
口 “模块 版 本 : 可 能 的 和 不 可 能 的 "， 第 13 章 
口 “通过 jlink 定制 运行 时 镜像 ~， 第 14 章 
太 棒 了 ， 我 想 了 解 全 部 
口 请 通读 本 书 。 如 果 你 并 不 需要 担心 任何 已 有 项 目 ， 可 以 将 第 二 部 分 “改写 现实 世界 中 的 
项 目 ” 留 到 最 后 阅读 。 
不 论 你 选择 哪 一 条 阅读 路 径 ， 请 注意 提示 , 尤其 是 每 章 开头 和 结尾 的 那些 ,并 据 此 决定 接 下 
来 阅读 什么 。 


需要 注意 的 地 方 


本 书 引入 了 大 量 的 新 概念 、 示 例 、 小 提示 以 及 需要 牢记 的 内 容 。 为 了 便于 你 找到 想 要 阅读 的 
内 容 ， 本 书 突出 展示 了 以 下 信息 。 

新 概念 、 术 语 、 模 块 属性 以 及 命令 行 选项 的 定义 用 黑体 字 表示 。 最 重要 的 定义 被 放 在 了 灰色 
方 框 中。 这 些 是 本 书 中 最 重要 的 段落 ， 如果 需要 了 解 某 种 机 制 的 工作 原理 , 就 到 这 些 重要 段落 中 
查找 。 
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要 点 “用 此 图 标 标 识 的 段落 包含 了 与 当前 讨论 的 概念 最 相关 的 信息 ， 或 者 揭示 了 
一 些 不 明显 但 值得 记 住 的 事实 。 记 住 它们 吧 ! 





天 于 代码 


本 书 以 一 个 名 为 ServiceMonitor 的 应 用 程序 为 例 ， 讲 解 模块 系统 的 特性 和 行为 。 这 个 应 用 程 
序 的 下 载 网 址 为 www.manning.com/books/the-java-module-system。 
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几乎 每 章 都 使 用 了 这 个 应 用 程序 的 不 同 版 本 ， 它 们 之 间 有 些 细微 的 差别 。Git 代码 库 中 有 一 
些 分 支 分 别 展 示 了 本 书 第 一 部 分 ( 比如 master 和 一 些 preak-.. .分 支 ) 和 第 三 部 分 (单独 的 
feature-.. .和 男 外 一 些 preak-.. .分 支 ) 讲述 的 不 同 特 性 。 

第 二 部 分 主要 讲述 了 迁移 和 模块 化 挑战 ， 有 时 也 会 以 ServiceMonitor 为 例 ， 但 是 Git 代码 库 
中 没有 对 应 的 分 支 。 另 一 个 版 本 的 ServiceMonitor 展示 了 迁移 面临 的 几 个 问题 ， 可 以 在 GitHub 
网 站 上 搜索 nipafx/demo-java-9-migration 进行 下 载 。 

跟随 本 书 进行 编码 或 按照 示例 进行 实验 ， 仅 需要 Java 9 或 以 上 版 本 (参见 后 文 )、 一 个 文本 
编辑 器 以 及 一 些 最 基本 的 命令 行使 用 技巧 。 如 果 你 希望 在 IDE 中 编码 ， 那 么 它 需 要 支持 Java 9 
( 最低 版 本 要 求 : IntelliJIDEA 2017.2 、Eclipse Oxygen.1a 或 NetBeans 9 )。 建 议 你 通过 键入 命令 或 
者 执行 .sh 或 .pat 脚本 来 运行 应 用 程序 , 但 某 些 需要 构建 项 目的 用 例 可 以 使 用 3.5.0 及 以 上 版 本 
的 Maven。 

更 多 设置 细节 可 以 参阅 每 个 项 目的 README 文件 。 
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Java EE 变 成 Jakarta EE 

模块 系统 是 Java9 标准 版 (JavaSE9 ) 的 一 部 分 。 除 了 Java 标准 版 之 外 , Java 企业 版 (Java 
EE ) 目前 已 发 布 至 Java EE 8。 起 初 ，Java 标准 版 和 企业 版 管理 流程 相同 ， 并 且 由 同一 家 企业 
管理 : 开始 是 Sun 公司 ， 后 来 是 Oracle 公司 。 

2017 年 ， 事 情 发 生 了 变化 。Oracle 将 Java 企业 版 技术 移交 给 了 Eclipse 基金 会 ， 通 过 新 成 
立 的 Eclipse Java 企业 版 (Eclipse Enterprise for Java，EE4J ) 项 目 进 行 管理 。 此 后 ，Java 企业 
版 更 名 为 Jakarta 企业 版 ( Jakarta EE )， 后 者 的 第 一 个 发 行 版 为 Jakarta EE 8。 

本 书 中 不 时 会 提 及 Java 企业 版 和 Jakarta 企业 版 ，6.1 节 尤 其 如 此 。 为 了 避免 这 两 个 项 目 可 
能 造成 的 混淆 ， 以 及 区 分 一 项 技术 在 形式 上 依旧 属于 Java 企业 版 还 是 已 经 归属 至 Jakarta 企业 
版 ， 本 书 将 统一 使 用 JEE 这 个 缩写 形式 。 

















本 书 是 在 Java 9 发 布 之 初 写 的 ， 所 有 代码 都 保证 可 以 在 Java9 (准确 的 版 本 号 是 9.0.4 ) 上 正 
常 运 行 。 同时， 本 书 代 码 针 对 Java 10 和 Java 11 进行 了 测试 和 更 新 。 由 于 在 本 书 英文 版 准备 印刷 
时 Java 11 仍 处 于 早期 测试 阶段 ， 因 此 有 可 能 其 正式 发 布 前 的 细小 改动 没有 反映 在 本 书 中 。 

Java9 不仅 引入 了 模块 系统 , 同时 还 将 Java 主要 版 本 的 发 布 周期 缩短 为 6 个 月 。 所 以 Java 10 
和 Java 11 已 经 发 布 了 , 甚至 Java 12 也 将 很 快 发 布 ( 取决 于 你 何 时 阅读 本 书 , 很 可 能 已 经 发 布 了 )。 
这 是 否 意味 着 本 书 已 经 过 时 了 ? 

幸好 完全 没有 过 时 。 除 了 一 些 细节 ，Java 10 和 Java 11 没有 对 模块 系统 进行 任何 改变 ; 即使 
展望 未 来 ， 也 没有 计划 进行 重大 的 改变 。 所 以 ,虽然 本 书 主要 基于 Java 9, 但 是 这 些 内 容 均 适用 
于 Java 10、Java 11 及 之 后 的 更 多 版 本 。 
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对 于 本 书 第 二 部 分 的 兼容 性 挑战 而 言 尤其 如 此 。 放弃 模块 系统 ,直接 从 Java 8 切换 到 Java 10 
或 更 新 的 版 本 是 不 切实 际 的 。 与 此 同时 , 一旦 你 掌握 了 Java 9， 其余 的 将 是 小 菜 一 碟 ， 因 为 Java 10 
和 Java 11 是 变化 相对 较 少 的 发 行 版 ， 并 且 没 有 兼容 性 问题 。 


代码 格式 约定 


本 书 中 包含 许多 源 代 码 示 例 ， 有 些 以 代码 段 形 式 出 现 ， 有 些 则 穿插 在 正文 中 。 在 这 两 种 情况 
下 ， 为 了 与 普通 文本 相 区 分 ， 源 代码 以 如 下 字体 展示 。 


fixed-width font 


在 很 多 情况 下 ， 源 代码 和 编译 需 或 JVM 的 输出 已 经 通过 下 列 方式 重新 格式 化 ， 以 适应 书面 

排版 : 

口 添加 换行 符 并 重新 处 理 缩 进 ; 

口 省 略 部 分 输出 ， 例 如 删除 包 和 名 称 ; 
口 缩短 错误 信息 。 

在 极 少数 情况 下 ， 如 果 仍 不 满足 排版 需求 ， 就 在 代码 清单 中 包含 续 行 标记 (ee )。 此 外 ， 如 
果 正 文 段落 中 对 代码 进行 了 阐释 , 那么 源 代 码 中 就 不 再 添加 注释 。 许 多 代码 清单 中 添加 了 代码 注 
释 ， 以 突出 重要 概念 。 

从 Java 8 开始 , 通常 使 用 “方法 引用 语法 ”来 引用 类 的 方法 ,所 以 引用 List 类 中 的 aaa 方 
法 使 用 的 是 List : :agq 而 非 List .adg。 这 样 看 起 来 并 不 像 真 正 的 方法 调用 , (方法 调用 的 括号 
去 哪儿 了 ? ) 同时 也 回避 不 了 重 载 函数 的 问题 。 实际 上 , List : :agd 是 指 ada 方法 的 所 有 重 载 ， 
而 不 只 是 其 中 一 个 。 本 书 中 均 使 用 这 种 语法 。 


模块 命名 约定 
























































































































































要 点 ”模块 名 称 几 乎 和 包 名 称 一 样 长 ， 在 源 代 码 和 图 表 中 占据 了 过 多 的 空间 。 为 
了 避免 这 一 点 ， 本 书 中 所 有 自 定义 的 模块 均 使 用 了 “危险 的 ” 短 名 称 。 在 实际 的 
项 目 中 请 不 要 这 么 做 ! 请 遵循 3.1.3 节 的 做 法 。 


因为 包 名 称 和 模块 名 称 非常 类 似 ， 所 以 我 决定 使 用 fixed-width font (等 宽 字体 ) 表示 
包 名 称 ， 这 样 可 以 将 它们 区 分 开 。 如 果 你 编写 关于 模块 的 内 容 ， 建 议 你 使 用 同样 的 风格 。 
代码 中 的 占 位 符 


一 些 新 特性 ,比如 命令 行 参数 和 modqule-info.java 中 的 内 容 , 是 通过 通用 术语 来 定义 的 。 
因此 ， 我 们 必须 使 用 $ {placeholders} 来 指明 自 定义 的 数值 会 在 哪里 。 你 可 以 使 用 美元 符号 紧 
跟 大 括号 来 标识 它们 。 
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这 种 语法 专门 用 于 该 上 下 文 ， 它 与 某 些 操作 系统 和 编程 语言 引用 参数 或 者 变量 的 语法 相似 ， 
这 一 点 并 非 偶然 。 但 是 它 并 没有 引用 特定 的 机 制 , 且 占 位 符 从 来 不 由 操作 系统 或 者 JVM 来 赋值 。 
你 需要 根据 实际 情况 自行 替换 ， 通 常 可 以 在 占 位 符 附近 找到 关于 实际 值 的 解释 。 


示例 
摘自 4.5.3 节 














当 使 用 jar 命令 打包 类 文件 时 ， 可 以 使 用 --main-class S${class} 定 义 一 个 主 
类 ,其 中 $f{class} 是 包含 main 函数 的 类 的 完全 限定 名 称 ( 即 包 名 后 加 点 号 再 加 类 名 )。 


很 容易 ， 对 吧 ? 


























命令 及 其 输出 
了 解 模块 系统 的 最 佳 方法 是 直接 使 用 javac、java 和 其 他 命令 , 然后 检查 Java 通过 命令 行 


打印 的 输出 。 因 此 ， 本 书包 含 了 许多 命令 和 消息 之 间 的 交互 。 在 源 代码 片段 中 , 命令 行 的 前 级 是 
s， 消 息 的 前 级 是 >， 我 写 的 注释 的 前 级 是 #。 









































示例 
以 下 是 5.3.2 节 中 的 命令 。 
$ java 


--module-path mods 
--validate-modules 


# 省 略 了 标准 化 Java 模块 

# 省 略 了 非 标 准 化 JDK 模块 

> file:.../monitor.rest.jar monitor.rest 

> file:.../monitor.observer.beta.jar monitor.observer.beta 


本 书 论坛 
购买 了 本 书 英文 版 的 读者 可 以 同时 获得 由 Manning 出 版 社 提供 的 私人 网 络 论坛 的 访问 权限 ， 
在 论坛 上 你 可 以 发 表 对 图 书 的 评论 ， 询 问 技术 问题 ， 并 从 作者 和 其 他 读者 那里 获得 帮助 。 
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天 于 封面 插图 


本 书 封面 上 的 插图 名 为 “佛罗里达 居民 ”， 图 中 是 来 自 佛罗里达 州 的 一 位 原 住民 男子 。 插 图 
取 自 1788 年 于 法 国 出 版 的 各 国 服饰 选集 , 作者 是 Jacques Grasset de Saint-Sauveur ( 1757 一 1810 )。 
每 幅 插图 都 经 过 了 精心 绘制 、 手 工 着 色 。 该 服饰 选集 的 多 样 化 向 人 们 生动 地 展示 了 200 多 年 前 世 
界 各 地 绚丽 多 彩 的 文化 。 当 时 人 们 彼此 隔绝 , 不 同城 镇 、 区 域 的 人 说 着 不 同 的 方言 甚至 不 同 的 语 
言 。 无 论 在 城市 街头 还 是 乡村 小 径 ， 仅 从 服饰 上 就 很 容易 区 分 人 们 住 在 哪里 ， 从 事 什 么 工作 。 

在 那 之 后 ， 人 们 的 着 装 发 生 了 很 大 变化 ,丰富 的 区 域 多 样 性 也 逐渐 消失 了 。 现 在 ， 很 难 从 服 
装 上 区 分 不 同 大 洲 的 居民 ， 更 不 用 说 不 同城 镇 、 地 区 或 国家 的 居民 了 。 或 许 ， 丰富 多 彩 的 个 人 生 
活 取 代 了 文化 的 多 样 性 一 一 人 们 实现 了 快 节奏 、 个 性 化 的 科技 生活 。 

今天 ， 人 们 很 难 将 一 本 计算 机 图 书 与 另外 一 本 区 分 开 ，Manning 出 版 社 在 图 书 封 面 上 展示 了 
两 个 世纪 前 地 区 生活 的 多 样 性 ( 通过 Jacques Grasset de Saint-Sauveur 的 插图 重 现 )， 以 此 赞扬 计 
算 机 行业 的 发 明 与 创新 。 



























































第 一 部 分 





你 好 ， 模 块 
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你 好 ， 模 块 























在 Java 9 中 ， 模 块 化 是 头等 概念 〈 first-class concept )。 但 什么 是 模块 ? 它 解 决 了 哪些 问题 ? 
人 们 如 何 从 中 获 益 ? 头等 概念 是 什么 意思 ? 

本 书 将 回答 所 有 这 些 问题 ， 且 不 止 于 此 。 本 书 将 教 你 如 何 定义 、 构 建 和 运行 模块 ， 介 绍 模块 
对 现 有 项 目的 影响 以 及 它们 带 来 的 好 处 。 

这 一 切 都 会 在 适当 的 时 候 逐 一 介绍 。 本 部 分 首先 解释 了 模块 化 (modularity ) 的 含义 、 迫 切 
需要 它 的 原因 ， 以 及 模块 系统 的 目标 (第 1 章 )。 第 2 章 展示 了 定义 、 构 建 和 运行 模块 的 代码 实 
例 ， 第 3~5 章 则 具体 介绍 了 这 三 个 步 又。 第 3 章 特别 重要 ， 因 为 它 介绍 了 模块 系统 的 基本 概念 和 
底层 机 制 。 

本 书 第 二 部 分 讨论 了 Java 9 给 现 有 应 用 程序 带 来 的 挑战 ,第 三 部 分 介绍 了 模块 系统 的 高 级 
特性 。 



































第 一 块 拼图 








本 章 内 容 

口 模块 化 及 其 塑造 系统 的 原理 

口 Java 实施 模块 化 的 障碍 

口 新 模块 系统 解决 这 些 问题 的 方法 


























我 们 都 经 历 过 部 署 的 软件 不 按 预期 工作 的 情况 。 导 致 这 种 情况 的 原因 很 多 , 但 是 其 中 一 类 问 
题 很 讨厌 ， 以 致 获得 了 一 个 如 雷 贯 耳 的 名 字 : JAR 地 狱 (JAR hell )。 经 典 的 JAR 地 狱 问题 是 依 
赖 错误 : 某 个 依赖 包 缺 失 , 或 是 某 个 依赖 包 被 多 次 包含 , 并 且 很 可 能 以 不 同 版 本 的 形式 被 多 次 包 
含 。 这 类 问题 一 定 会 造成 程序 崩溃 ， 更 糟糕 的 是 ， 会 悄 无 声息 地 破坏 运行 中 的 程序 。 

造成 JAR 地狱 的 根本 原因 是 ,我 们 把 JAR 视 为 具有 标识 和 相互 关系 的 工件 ,而 Java 认 为 JAR 
是 没有 任何 有 意义 属性 的 类 文件 容器 。 这 种 差异 导致 了 问题 。 

一 个 例证 就 是 缺乏 有 意义 的 JAR 封装 : 同一 应 用 程序 的 所 有 代码 都 可 以 自由 访问 所 有 公有 
类 型 。 这 容易 导致 依赖 于 某 个 库 中 的 类 型 ， 但 是 该 库 的 维护 者 认为 这 些 类 型 只 是 内 部 实现 细节 ， 
而 没有 将 它们 打磨 到 可 公开 使 用 。 这 些 类 型 通常 被 隐藏 在 名 为 internal 或 impl 的 包 中 , 但 这 
并 不 能 阻止 它们 被 引用 。 

于 是 ， 当 类 库 维 护 者 修改 这 些 内 部 实现 时 ,我们 的 代码 也 将 受到 影响 。 或 者 ， 如 果 我 们 在 社 
区 中 拥有 足够 的 影响 力 , 那么 维护 者 可 能 会 被 迫 保留 内 部 实现 细节 的 代码 , 进而 妨碍 代码 的 重 构 
和 演变 。 缺 少 封装 会 同时 降低 类 库 和 应 用 程序 的 可 维护 性 。 

缺少 封装 对 日 常 开发 影响 较 小 ， 但 由 于 很 难 控制 对 安全 相关 代码 的 访问 ， 这 个 问题 给 整个 
Java 生态 系统 带 来 了 糟糕 的 影响 。 这 在 Java 开发 工具 包 ( Java Development Kit，JDK ) 中 造成 了 
一 系列 安全 隐患 ， 其 中 一 些 问 题 直接 导致 了 Oracle 收购 Sun 之 后 Java 8 的 延迟 发 布 。 

这 些 问题 已 经 困扰 Java 开发 人 员 20 多 年 了 ， 而 对 解决 方案 的 讨论 持续 了 同样 长 的 时 间 。 
Java 9 是 第 一 个 在 语言 层面 提供 解决 方案 的 版 本 : 自 2008 年 以 来 ，Jigsaw 项 目 一 直 在 开发 Java 
平台 模块 系统 ( Java Platform Module System, JPMS )。 它 使 开发 人 员 可 以 通过 将 元 信息 附加 到 JAR 
来 创建 模块 ， 从 而 使 JAR 不 再 仅仅 是 容器 。 从 Java 9 开始 ， 编 译 器 和 运行 时 开始 理解 模块 的 标 
识 和 模块 之 间 的 关系 ， 从 而 解决 了 缺少 依赖 、 重 复 依赖 和 缺少 封装 等 问题 。 

JPMS 不 仅仅 是 权宜 之 计 ， 它 同时 拥有 很 多 优秀 特性 ， 能 够 帮助 我 们 开发 更 加 精巧 、 更 易 维 








































































































































































































1.1 什么 是 模块 化 3 





护 的 软件 。 或 许 , 它 最 大 的 好 处 是 让 每 个 开发 人 员 和 社区 直面 模块 化 的 基本 概念 。 这 有 利于 培养 
知识 更 丰富 的 开发 人 员 、 构 建 更 多 的 模块 化 类 库 ， 以 及 提供 更 好 的 工具 支持 一 一 在 模块 化 是 一 等 
公民 的 Java 世界 中 ， 这 些 收 益 值 得 期 待 。 

意识 到 许多 开发 人 员 在 进行 Java 升级 时 会 跳 过 多 个 版 本 , 例如 从 Java 8 直接 升级 到 Java 11。 
我 会 提醒 大 家 注意 Java 9、Java 10 和 Java 11 之 间 的 差异 。 本 书 中 的 大 部 分 内 容 适 用 于 Java 9 及 
以 上 版 本 。 

1.1 节 将 开始 探讨 什么 是 模块 化 ， 以 及 通常 如 何 看 待 软件 系统 的 结构 。 关 键 在 于 ， 在 特定 的 
抽象 级 别 (JAR ) 上 ，JVM 看 到 的 与 我 们 所 看 到 的 不 同 (1.2 节 )。 相反 ，JVM 擦 除了 我 们 精心 创 
建 的 结构 ! 此 种 差异 导致 的 现实 问题 将 在 1.3 节 进 行 讨论 。 创 建 模块 系统 是 为 了 将 工件 转变 为 模 
块 (1.4 节 ) 并 解决 这 种 差异 导致 的 问题 (1.5 欧 。 


1.1 什么 是 模块 化 


你 是 如 何 看 待 软件 的 ?它们 是 一 些 代 码 行 ?9 一 堆 位 ( bit ) 和 字 节 ? 一 些 UML 图 ? 抑或 Maven 
POM? 

本 书 试图 寻找 的 是 对 软件 的 直观 认识 ,而 非 定义 。 花 点 时 间 想 想 你 最 喜欢 的 项 目 (或 者 你 受 
雇 参 与 的 项 目 )。 感觉 如 何 ? 你 有 办 法 将 它 可 视 化 吗 ? 


1.1.1 用 图 将 软件 可 视 化 


我 将 自己 工作 的 代码 库 视 作 由 交互 部 件 构 成 的 系统 ( 对 ， 就 是 这 么 正式 )。 每 个 部 件 有 3 个 
基本 属性 : 名 称 、 对 其 他 部 件 的 依赖 和 提供 给 其 他 部 件 的 功能 。 

每 个 抽象 级 别 都 是 如 此 。 在 非常 低 的 级 别 上 ， 部 件 对 应 单个 方法 : 名 称 是 方法 名 ,依赖 是 调 
用 的 方法 ,功能 是 方法 返回 值 或 状态 改变 。 在 非常 高 的 级 别 上 ， 部件 对 应 服务 (有 人 认为 是 微服 
务 吗 ? ) 或 者 整个 应 用 程序 。 

想象 一 下 某 个 结账 服务 。 作 为 电子 商店 的 一 部 分 , 该 服务 使 用 户 可 以 购买 所 挑选 的 商品 。 为 
此 ， 需 要 调用 登录 和 购物 车 服务 。 它 同样 拥有 所 有 的 3 个 属性 : 名 称 、 依 赖 和 功能 。 使 用 这 些 信 
息 ， 可 以 轻松 绘制 图 1-1。 

我 们 可 以 感受 不 同 抽象 级 别 上 的 部 件 。 从 方法 到 整个 应 用 程序 ， 可 以 将 部 件 映射 到 类 、 包 和 
JAR。 它们 都 具有 和 名称 、 依 赖 和 功能 等 属性 。 

这 个 观点 的 有 趣 之 处 在 于 ,如 何 使 用 它 对 系统 进行 可 视 化 和 分 析 。 如 果 我 们 为 每 个 想到 的 部 
件 绘制 一 个 节点 ， 然 后 根据 依赖 关系 用 边 连接 这 些 节 点 ， 将 得 到 一 幅 图 ( graph )。 










































































































































CheckoutService 


POST checkoutCart 
(ShoppingCartld) 








LoginService ShoppingCartService 


GET userLoggedln(Userld) GET cart(ShoppingCartld) 








功能 


图 1-1 如 果 记 录 结 账 服务 及 其 依赖 ， 将 自然 形成 包含 名 称 、 依 赖 和 功能 的 简单 图 











这 种 映射 非常 自然 ， 以 至 于 电子 商店 的 例子 已 经 实现 了 它 ， 而 你 可 能 没有 注意 到 。 图 1-2 展 
示 了 将 软件 系统 可 视 化 的 其 他 常用 方法 ， 图 随处 可 见 。 


org.jooq:joogq 
+- 1094j:10g4j 
+- org.slf4j:;integration 
| +- org.slf4j:slf4j-api 







Component 
+ Operation() 
ConcreteComponent 
+ operation() 





| +- junit:junit 
| +- ant:ant-junit 
| ~- org.apache. felix 


Decorator 
- component 
+ operation() :org.apache. felix.main 
| ~\- org.apache. felix 


:org.apache. felix. framework 


ConcreteDecorator ~\- javax.persistence 
+ operation() ‘javax, persistence-api 








图 1-2 在 软件 开发 中 ， 图 无 处 不 在 。 它 们 以 各 种 形状 和 形式 出 现 ,例如 ，UML 图 ( 左 )、 
Maven 依赖 树 ( 中 ) 和 微服 务 连 接 图 ( 右 ) 


类 图 (class diagram ) 也 是 图 。 构建 工具 输出 的 类 似 于 树 状 结构 的 依赖 关系 ( 如 果 使 用 Gradle 
或 Maven， 要 执行 gradle dependencies 或 mvn dependency :tree) 是 一 种 特殊 的 图 。 你 
看 过 那些 疯狂 的 、 难 以 理解 的 微服 务 图 吗 ? 它们 也 是 图 。 

根据 是 在 谈论 编译 时 依赖 还 是 运行 时 依赖 ， 是 只 看 一 个 抽象 级 别 还 是 将 不 同 的 抽象 级 别 混 
合 , 是 检查 系统 的 整个 生存 期 还 是 仅仅 检查 某 个 时 刻 ， 以 及 许多 其 他 区 别 ,， 这些 图 看 起 来 会 有 很 
大 不 同 。 一 些 区 别 以 后 会 比较 重要 , 但 目前 无 须 深 入 了 解 细节 。 现 在 ， 无 数 的 图 都 满足 需求 ， 所 
以 请 想象 一 下 你 觉得 最 舒服 的 那 一 种 。 
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1.1.2 设计 原则 的 影响 i 


将 系统 可 视 化 为 图 ,是 分 析 系 统 架 构 的 常用 方法 ,许多 软件 设计 原则 可 以 直接 影响 图 的 外 观 。 

以 分 离 关 注 点 这 一 设计 原则 为 例 。 采用 此 原则 开发 软件 时 ,每 个 部 件 只 关注 一 个 任务 ( 比如 
“用 户 登 录 ” 或 “绘制 地 图 ”)， 而 任务 通常 由 更 小 的 子 任务 构成 ( 比如 “加 载 用 户 ” 和 “验证 密 
码 ”)， 实 现任 务 的 部 件 也 遵照 此 原则 划分 。 实 现 不 同 功能 的 多 个 小 部 件 相互 聚合 ， 最 终 形 成 图 。 

相反 , 如果 关 注 点 分 离 得 较 差 , 图 就 没有 清晰 的 结构 , 各 个 节点 相互 连接 , 看 起 来 一 团 乱 麻 。 
如 图 1-3 所 示 ， 这 两 种 情况 很 容易 区 分 。 


ee 有 ee 

















更 加 清晰 ， 
易于 理解 


图 1-3 ”两 个 用 图 描述 的 系统 架构 。 节 点 可 以 是 JAR 或 者 类 ， 边 是 节点 间 的 依赖 。 
然而 细节 并 不 重要 : 快速 浏览 一 下 ， 0 
依赖 反 转 是 另 一 条 会 影响 图 的 样式 的 设计 原则 。 在 运行 时 ， 上 层 代 码 始终 调用 底层 代码 , 但 
设计 良好 的 系统 在 编译 时 会 反 转 依赖 关系 : 上 层 代 码 依赖 于 接口 ， 底 层 代 码 实 现 接口 ， 从 而 将 依 
赖 向 上 反 转 到 接口 。 请 看 图 1-4， 这 些 反 转 很 容易 发 现 。 
所 撤 者 指 

































\ 重要 的 系统 组 件 


3 W 2 


1-4 上 层 代码 依赖 底层 代码 的 系统 创建 的 图 ( 左 )， 与 采用 接口 向 上 反 转 依赖 的 系统 
创建 的 图 ( 右 ) 不 同 。 依 赖 反 转 有 利于 识别 和 理解 系统 中 有 意义 的 组 件 
将 图 理 顺 是 诸如 关注 点 分 离 和 依赖 反 转 等 原则 的 目标 。 如 果 忽 略 这些 原 则 , 那么 系统 会 变 得 
一 团 糟 ， 任 何 变 更 都 会 破坏 看 似 不 相关 的 部 分 。 如 果 遵 循 这 些 原则 ， 则 可 以 很 好 地 组 织 系统 。 


分 依赖 被 反 转 
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1.1.3 ”什么 是 模块 化 


软件 设计 原则 指导 我 们 如 何 理 顺 系统 。 有趣 的 是 , 尽管 目标 是 提高 系统 的 可 维护 性 ， 大 多 数 
以 此 为 目标 的 原则 却 将 注意 力 集中 到 单个 部 件 上 。 重 点 之 所 以 不 在 于 整个 代码 库 而 在 于 单个 部 
件 ， 是 因为 所 有 部 件 的 特性 决定 了 所 构成 的 系统 的 特性 。 

我 们 学 习 了 关注 点 分 离 和 依赖 反 转 所 具有 的 两 个 良好 特性 : 专注 于 单个 任务 , 以 及 依赖 于 接 
口 而 不 是 实现 。 系 统 部 件 的 良好 特性 总 结 如 下 。 


从 要 点 ”每 个 模块 (也 就 是 前 文 提 到 的 部 件 ) 都 有 清晰 的 责任 和 要 实现 的 明确 协议 。 
乱 ) 模块 是 自 包 含 的 并 且 对 客户 端 不 透明 ， 可 以 被 实现 了 相同 协议 的 模块 替换 。 它 依 
赖 少 量 的 API 而 不 是 实现 。 


基于 这 些 模块 构建 的 系统 能 更 加 从 容 地 应 对 变化 , 并 且 只 要 依赖 模块 实现 得 合理 , 它们 在 启 
动 甚至 运行 时 也 会 更 加 灵活 。 这 就 是 模块 化 : 通过 设计 良好 的 模块 实现 可 维护 性 和 灵活 性 。 


1.2 Java 9 之 前 的 模块 擦 除 


前 文 已 经 展示 了 由 交互 部 件 构成 的 图 带 来 的 良好 特性 , 这 些 特 性 通常 被 概括 为 模块 化 。 但 它 
们 毕 况 只 是 想法 ， 即 谈论 软件 的 方法 。 图 只 是 一 行 行 代码 ，( 以 Java 为 例 ) 这 些 代 码 最 终 被 编译 
成 字 节 码 指令 并 由 JVM 执行 。 如 果 语 言 、 编 译 需 和 JVM (粗略 地 归结 为 Java ) 能 够 拥有 人 的 视 
角 ， 那 将 会 很 棒 。 

通常 情况 下 ， 确 实 如 此 。 如 果 你 设计 类 或 接口 ， 那 么 名 称 就 是 Java 使 用 的 标识 。 你 定义 为 
API 的 方法 正 是 其 他 代码 调用 的 接口 一 一 具有 相同 的 方法 名 和 参数 类 型 。 它 的 依赖 非常 清晰 ,无 
论 是 导入 语句 还 是 完全 限定 的 类 名 都 是 如 此 ， 编 译 需 和 JVM 将 使 用 这 些 名 称 所 对 应 的 类 来 满足 
其 所 需 依赖 。 

以 Future 接口 为 例 , 它 表 示 可 能 完成 或 尚未 完成 的 计算 结果 。 它 的 功能 并 不 重要 ， 因 为 我 
们 只 对 依赖 感 兴趣 。 


public interface Future<V> { 






























































































































































boolean cancel (boolean mayInterruptIfRunning); 
boolean isCancelled(); 
boolean isDone(); 
V get() throws InterruptedException, ExecutionException; 
V get (long timeout, TimeUnit unit) 
throws InterruptedException, 
ExecutionException, 
TimeoutException; 


} 


通过 Future 接口 的 方法 声明 ， 很 容易 枚 举 它 的 依赖 。 


口 InterruptedException 








口 ExecutionException 
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D TimeUnit 








D TimeoutException 
将 相同 的 分 析 应 用 于 这 些 类 型 ， 可 以 得 到 如 图 1-5 所 示 的 依赖 关系 。 图 的 具体 形式 不 重要 。 重 
要 的 是 ， 当 我 们 谈论 一 个 类 型 时 ， 所 想到 的 依赖 关系 图 和 Java 隐 式 创建 的 依赖 关系 图 是 一 致 的 。 


依赖 关系 图 更 多 依赖 
从 此 处 开始 


全 
Future 
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Interrupted 


i 
Execution 
ks 区 


图 1-5 ”对 于 任何 给 定 类 型 ，Java 操作 的 依赖 关系 图 与 我 们 对 类 型 依赖 关系 的 感知 一 致 。 图 中 
显示 Future 接口 依赖 java.util.concurrent 包 和 java.lang 包 


由 于 Java 是 强 静 态 类 型 的 语言 , 因此 一 旦 有 错误 它 会 立即 报告 。 类 的 名 称 非 法 ?依赖 丢失 ? 
方法 的 可 见 性 发 生 改 变 ， 使 得 调用 方 看 不 见 它 ”Java 编译 器 和 JVM 将 分 别 报告 编译 期 间 和 执行 
期 间 的 问题 。 

反射 (参见 附录 B ) 会 绕 过 编译 时 检查 。 因 此 它 被 认为 是 潜在 的 危险 工具 ， 仪 适用 于 特殊 场 
合 。 后 面 的 章节 中 会 讨论 反射 ， 本 章 暂 时 忽略 它 。 

人 们 对 依赖 以 及 依赖 关系 的 理解 与 Java 存在 分 层 ， 我们 以 服务 或 应 用 程序 级 别 为 例 。 以 下 
内 容 不 在 Java 的 职责 范围 内 : 知道 应 用 程序 的 名 称 ; 告诉 你 没有 “GitHab” 服 务 或 “Oracel” 数 
据 库 (有 拼写 错误 的 名 称 ) 知道 你 更 改 了 服务 的 API 并 影响 了 客户 端 。Java 缺少 映射 到 应 用 程 
序 或 服务 的 结构 。 这 没什么 影响 ， 因 为 Java 运行 在 单个 应 用 程序 的 级 别 上 。 

但 有 一 个 抽象 级 别 显然 属于 Java 的 范围 , 尽管 在 Java9 之 前 , 对 它 的 支持 非常 差 一 一 差 到 模 
块 化 工作 失去 了 意义 ， 从 而 导致 了 所 谓 的 模块 擦 除 ( module erasure )。 该 抽象 级 别称 为 工件 
(artifact ), 或 Java 术语 中 的 JAR。 

如 果 应 用 程序 在 JAR 级 别 上 模块 化 ， 那 么 它 就 由 多 个 JAR 组 成 。 即 便 不 是 如 此 ， 它 的 依赖 库 
也 会 有 自己 的 依赖 关系 。 记 下 这 些 ， 最 终 会 获得 已 经 熟悉 的 图 ， 但 图 中 的 节点 是 JAR， 而 不 是 类 。 

例如 ， 考 虑 一 个 名 为 ServiceMonitor 的 应 用 程序 。 忽 略 细节 ， 它 的 行为 大 致 如 下 : 通过 网 络 

仿 查 其 他 服务 的 可 用 性 并 聚合 统计 信息 。 这 些 统计 信息 被 写 和 数据库， 并 通过 REST API 对 外 提 
供 服 务 。 
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该 应 用 程序 创建 了 4 个 JAR。 

口 observer 一 一 观察 其 他 服务 并 检查 可 用 性 。 

D statistics 一 一 把 可 用 性 数据 聚合 成 统计 信息 。 

口 persistence 一 一 通过 hibernate 把 统计 信息 读 写 到 数据 库 。 


口 monitor 一 一 触发 数据 收集 ， 并 将 数据 从 statistics 一 路 发 送 到 persistence ， 采 用 spark 
实现 REST API。 


每 个 JAR 都 有 自己 的 依赖 ， 如 图 1-6 所 示 。 





依赖 关系 图 


从 此 处 开始 ~ 





更 gz 信 粕 1， S 


‘ 


图 1-6 对 于 任何 应 用 程序 都 可 以 绘制 依赖 关系 图 。 此 人 处 ServiceMonitor 应 用 程序 被 拆 
分 为 4 个 JAR， 它 们 相互 依赖 ， 另 外 还 依赖 第 三 方 类 库 








此 图 包括 了 前 面 讨论 的 一 切 : JAR 有 和 名称， 彼此 依赖 ， 每 个 JAR 的 功能 通过 公有 类 和 方法 
的 形式 供 其 他 JAR 调用 。 
启动 应 用 程序 时 ， 必 须 在 类 路 径 上 列 出 所 有 要 使 用 的 JAR。 


$ java 


--cClass-path observer.jar:statistics.jar:persistence.jar:monitor.jar 
org.codefx.monitor.Monitor 





通过 --class-path 选项 (-cp 和 -classpath 的 
新 替代 选项 , 同时 对 javac 有 效 ) 明确 地 列 出 所 需 
的 JAR 文件 


ba 要 点 ”此 处 会 出 问题 , 至少 在 Java9 之 前 会 出 现 问题 。JVM 启动 时 缺少 所 需 类 的 

知 ) 信息 。 从 命令 行 的 main 开始 ， 每 次 引用 未 知 的 类 时 ， 它 都 会 遍历 类 路 径 中 的 所 
有 JAR， 并 查找 具有 完全 限定 名 称 的 类 。 如 果 找 到 一 个 ， 就 加 载 到 一 个 巨大 的 类 
集合 中 。 如 上 所 述 ， 在 JVM 中 没有 与 JAR 相对 应 的 运行 时 概念 。 
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由 于 缺少 标识 ， 运 行 时 丢失 了 JAR 的 信息 (虽然 JAR 有 文件 名 , 但 JVM 并 不 关心 ) 如 果 
异常 信息 可 以 指出 发 生 问题 的 JAR， 或 者 JVM 可 以 命名 缺失 的 依赖 项 ， 这 难道 不 是 更 好 吗 ? 

与 此 同时 , 依赖 也 变 得 不 可 见 。 在 类 的 级 别 操作 时 , JVM 没有 JAR 之 间 依 赖 关 系 的 概念 。 同 时 ， 
忽略 包含 类 的 工件 意味 着 不 能 封装 这 些 工 件 。 而 且 事 实 上 ， 每 个 公有 类 对 所 有 其 他 类 都 是 可 见 的 。 

名 称 、 显 式 依赖 和 明确 定义 的 API 等 模块 信息 虽然 重要 ， 但 编译 器 和 JVM 并 不 关心 它们 。 
这 会 擦 除 模块 化 结构 ， 并 将 精心 设计 的 图 变 成 一 团 乱 麻 (如 图 1-7 所 示 )， 还 将 导致 一 系列 后 果 。 


不 同类 型 JAR 中 的 类 最 终 都 
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混在 一 起 加 载 到 单个 命名 


被 混 
空间 











































fokey | spark. Request | monitor.Monitor | moniiorstatstics Statstician 


Spark. 
到 | spark.Response | | monitor.observer.Observer | org.hibernate.ejb.EntityManagerlmpl 0 


.Statistics | spark.Service | monitor.persistence.StatistiosEntity| monitor.MonitorServe 



























































图 1-7 ”Java 编译 器 和 虚拟 机 没有 JAR 以 及 JAR 之 间 依 赖 关 系 的 概念 。 相 反 ，JAR 仅 
被 视 为 简单 的 类 容器 ， 其 中 的 类 被 加 载 到 单个 命名 空间 。 最 终 这 些 类 处 于 一 种 
混沌 状态 ,任何 公有 类 型 都 可 以 相互 访问 








1.3 Java 9 之 前 的 问题 


如 前 文 所 述 ，Java9 之 前 的 版 本 缺乏 跨 工 件 的 模块 化 概念 。 这 虽然 会 引起 问题 ， 但 显然 没有 
严重 到 令 人 望而却步 〈 和 否则 人 们 不 会 使 用 Java )。 但 如 果 在 较 大 的 应 用 程序 中 出 现 此 问题 ， 则 可 
能 很 难 解 决 ， 甚 至 无 法 解决 。 

正如 本 章 开头 提 到 的 ， 最 可 能 影响 应 用 程序 开发 人 员 的 问题 被 总 结 为 JAR 地 狱 ， 但 这 并 不 
的 问题 。 更 严重 的 是 ，JDK 和 类 库 开发 者 同时 面临 安全 性 和 可 维护 性 的 难题 。 

你 肯定 见 过 其 中 的 一 些 问 题 ， 本 市 将 逐一 进行 研究 。 如 果 不 熟 悉 它 们 ， 请 不 要 担心 。 相 反 ， 
你 很 绊 运 ， 因 为 你 尚未 遇 到 它们 。 如 果 你 熟悉 JAR 地 狱 和 相关 问题 ， 请 直接 跳 到 1.4 节 。 

如 果 看 似 无 穷 无 尽 的 问题 让 你 感到 诅 丧 ， 请 放松 ， 有 一 个 解决 方案 : 1.5 将 讨论 模块 系统 
如 何 克 服 这 些 难题 。 


1.3.1 JAR 之 间 未 言明 的 依赖 
你 是 否 曾 经 遇 到 过 应 用 程序 因 NoclassDefFoundError 而 骨 泪 ? 当 JVM 无 法 找到 正在 执 
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行 的 代码 所 依赖 的 类 时 ， 将 出 现 这 种 情况 。 查 找 依赖 很 容易 〈 查看 一 下 跟踪 栈 )， 识 别 缺 失 的 依 
赖 也 不 困难 ( 可 通过 缺失 的 类 名 判断 )， 但 确定 缺失 依赖 的 原因 可 能 很 困难 。 考 虑 到 工件 依赖 关 
系 图， 问题 的 关键 在 于 ， 为 何 只 在 运行 时 才 发 现 缺 失 依 赖 。 


要 点 原因 很 简单 : JAR 无 法 以 JVM 可 以 理解 的 方式 表述 所 依赖 的 其 他 JAR， 
因而 需要 借助 外 部 实体 来 标识 和 解决 依赖 。 


在 构建 工具 获得 标识 部 件 和 获取 依赖 的 能 力 之 前 , 所 谓 的 外 部 实体 就 是 我 们 自己 。 我 们 必须 
查阅 文档 来 了 解 依 赖 关 系 ， 找 到 合适 的 项 目 并 下 载 JAR 包 ， 然 后 将 它们 添加 到 项 目 中 。 对 于 可 
选 依赖 ， 只 有 我 们 想 使 用 某 些 特 性 时 ， 某 个 JAR 才 可 能 依赖 另 一 个 JAR， 这 种 情况 将 问题 变 得 
更 加 复杂 。 

应 用 程序 要 正常 工作 可 能 只 需要 少量 类 库 , 但 这 些 类 库 又 可 能 需要 一 些 其 他 类 库 。 未 言明 的 
依赖 关系 使 问题 复杂 化 ， 而 解决 这 些 问 题 不 仅 耗 时 费力 还 容易 出 错 。 

要 点 ”诸如 Maven 和 Gradle 这 样 的 构建 工具 大 体 解 决 了 这 个 问题 ,它们 善于 明确 


依赖 关系 ， 进 而 从 依赖 树 具 有 传递 性 的 众多 边 中 搜索 到 需要 的 每 个 JAR。 但 是 ， 
让 JVM 理解 工件 依赖 的 概念 ， 对 提高 健壮 性 和 可 移植 性 仍 会 有 所 帮助 。 












































1.3.2 ”同名 类 的 覆盖 


有 时 类 路 径 中 不 同 的 JAR 会 包含 完全 限定 名 称 相 同 的 类 。 发 生 这 种 情况 有 多 个 原因 。 

口 引用 了 同一 个 类 库 的 两 个 版 本 。 

口 某 个 JAR 包含 了 它 自己 的 依赖 一 一 这 样 的 JAR 叫 作 胖 JAR (fatJAR ) 或 超级 JAR (uber 
JAR ) 一 一 但 其 中 一 些 也 被 作为 独立 的 JAR 引入 ， 因 为 其 他 工件 依赖 于 它们 。 

口 某 个 类 库 可 能 被 重 命名 或 拆 分 ， 它 的 一 些 类 型 无 意 间 被 两 次 添加 到 类 路 径 中 。 

















定义 : 覆盖 
因为 一 个 类 会 从 类 路 径 中 第 一 个 包含 它 的 JAR 中 加 载 ， 所 以 这 个 类 会 导致 所 有 其 他 同名 
类 不 可 用 ， 这 被 称 为 覆盖 。 





如 果 这 些 同 名 类 在 语义 上 存在 区 别 ， 那 么 可 能 会 造成 不 同 程度 的 后 果 : 从 不 易 察 觉 的 表现 不 
良 到 浩 动 般 的 灾难 。 更 糟糕 的 是 ， 同 一 个 问题 的 表现 形式 通常 是 不 确定 的 ， 这 取决 于 JAR 文件 的 
搜索 顺序 ， 而 搜索 顺序 又 取决 于 环境 , 例如 IDE ( IntellJ、Eclipse 或 NetBeans ) 和 最 终 的 生产 环境 。 
以 使 用 广泛 的 谷歌 Guava 类 库 为 例 。 它 包 含 一 个 工具 类 com.google.common.collect. 
Iterators， 其 中 的 emptyIterator () 方 法 在 版 本 19 升级 到 版 本 20 的 过 程 中 被 移 除 了 。 如 图 1-8 
所 示 ， 如 果 类 路 径 中 同时 含有 这 两 个 版 本 ， 并 且 版 本 20 先 被 加 载 , 那么 任何 依赖 于 Iterators 
的 代码 都 会 使 用 新 的 版 本 ,导致 它们 无 法 调用 版 本 19 中 的 Tterators: :emptyIterator 方法 。 
即使 包含 这 个 方法 的 类 存在 于 类 路 径 中 ， 它 也 是 不 可 见 的 。 
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Guava 20 比 Guava 19 
为 common .collect .Iterators 进 行 类 路 径 扫描 先 在 类 路 径 中 出 现 





f common.collect common.collect 









Guava 19 的 Iterators 不 会 被 加 载 ， 
它 被 Guava 20 的 版 本 覆盖 了 


Collections 和 Guava 


对 common .collect .BiMap 进 行 类 路 径 扫 描 有 一 些 相同 的 包 





common.collect 





Collections 先 出 现 ， 所 以 它 的 类 
将 Guava 中 的 类 和 覆盖 
图 1-8 类 路 径 中 包含 同一 个 库 的 两 个 版 本 (上 ), 或 者 两 个 库 包含 一 系列 相同 的 类 型 (下 ) 
都 是 有 可 能 的 。 在 这 两 种 情况 中 ， 一 些 类 型 出 现 了 不 止 一 次 。 在 类 路 径 扫描 中 只 有 
第 一 个 搜索 到 的 实例 〈 它 覆盖 了 所 有 其 他 实例 ) 会 被 加 载 ， 所 以 JAR 文件 的 扫描 顺 
序 决 定 了 哪些 代码 会 被 执行 
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虽然 覆盖 通常 是 意外 发 生 的 ,但 是 它 也 有 可 能 被 刻意 利用 ， 比 如 用 自己 的 代码 覆盖 第 三 方 
类 库 中 的 类 ， 为 第 三 方 类 库 打 补丁 。 虽 然 构建 工具 会 降低 这 种 意外 情况 发 生 的 概率 ， 但 无 法 完 
全 阻止 。 


1.3.3 同一 项 目 不 同 版 本 间 的 冲突 


版 本 冲突 在 任何 大 型 软件 项 目 中 都 是 祸根 。 一 旦 依赖 的 数量 不 再 是 个 位 数 , 版 本 冲突 出 现 的 
概率 就 会 以 知人 的 速度 通 近 100%。 








定义 : 版 本 冲突 
当 两 个 类 库 分 别 依赖 第 三 方 类 库 的 两 个 不 兼容 版 本 时 ， 就 会 发 生 版 本 冲突 。 


如 果 两 个 版 本 都 出 现在 类 路 径 中 , 那么 行为 会 变 得 不 可 预测 。 在 覆盖 效应 的 影响 下 ， 同 时 存 
在 于 两 个 版 本 中 的 类 只 会 从 其 中 一 个 版 本 加 载 。 雪 上 加 霜 的 是 , 如 果 有 一 个 类 只 存在 于 其 中 一 个 
版 本 中 , 那 它 在 受到 访问 时 也 会 被 加 载 。 调 用 该 类 库 的 代码 会 使 两 个 版 本 被 混合 加 载 。 

另外 , 如 果 其 中 一 个 版 本 丢失 , 那么 程序 很 可 能 无 法 正常 工作 ， 因 为 它 同时 需要 这 两 个 不 兼 
容 的 版 本 一 一 它们 无 法 相互 蔡 换 ( 如 图 1-9 所 示 )。 如 果 依 赖 丢失 ， 则 程序 会 表现 出 无 法 预测 的 
行为 ， 或 者 抛 出 NoCclassDefFoundError。 

















你 已 经 在 使 用 





RichFaces 使 用 了 一 个 7 
PI 


Guava 16 中 被 删除 的 A 


\ 你 想 要 使 用 


图 1-9 传递 依赖 引入 的 版 本 冲突 通常 无 法 解决 一 一 必须 去 除 其 中 一 个 依赖 。 图 中 ， 一 
个 旧版 本 的 RichFaces 类 依赖 Guava 的 不 同 版 本 。 不 幸 的 是 ，Guava 16 删除 
了 RichFaces 所 需要 的 某 个 API 
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继续 谈 前 面 介绍 的 Guava 的 例子 ， 想 象 一 下 一 些 代 码 依赖 于 com.google.common.io. 
InputSupplier， 版 本 19 中 存在 这 个 类 ， 但 版 本 20 将 其 移 除 了 。JVM 会 首先 扫描 Guava 20， 
但 无 法 找到 该 类 ， 于 是 它 从 Guava 19 中 加 载 。 突 然 间 两 个 Guava 版 本 的 混合 体 开始 运行 ! 最 后 
抛 出 一 记 必 杀 绝 招 : 想象 一 下 InputSupplier 调用 Iterators: :emptyIteratoro 感觉 怎么 


样 ? 调试 此 种 问题 会 多 么 “有 趣 ”。 


要 点 ”没有 哪个 技术 解决 方案 不 涉及 模块 系统 或 重 写 类 加 载 器 。 通 常 构建 工具 可 
全 以 侦 测 出 这 类 场景 , 发 出 警告 并 用 简单 的 机 制 进行 处 理 , 比如 仅 加 载 最 新 的 版 本 。 





1.3.4 复杂 的 类 加 载 


1.2 节 对 类 加 载 机 制 的 讲解 还 不 够 充分 ， 当 时 描述 的 仅仅 是 一 个 类 加 载 器 加 载 所 有 类 的 默认 
行为 。 但 是 开发 者 可 以 自由 添加 额外 的 类 加 载 器 ， 并 将 类 加 载 由 一 个 加 载 器 委托 给 另 一 个 ， 以 解 
决 当前 正在 讨论 的 问题 。 

这 些 往往 通过 诸如 组 件 系统 和 Web 服务 吉之 类 的 容 铝 来 实现 。 理 想 情 况 下 ， 这 种 使 用 方式 
对 开发 者 而 言 是 隐藏 的 , 但 众所周知 ， 所 有 的 抽象 都 是 有 漏洞 的 。 在 某 些 情况 下 ,开发 者 会 通过 
显 式 地 添加 类 加 载 右 来 实现 某 些 特性 , 例如 允许 用 户 通 过 加 载 新 类 来 扩展 功能 , 或 者 允许 使 用 同 
一 个 依赖 的 冲突 版 本 。 

不 论 为 何 牵 扯 到 多 个 类 加 载 器 , 它们 都 要 求 你 更 深入 地 了 解 这 个 话题 ,并且 它们 会 很 快 引 入 
复杂 的 代理 机 制 ， 进 而 展现 出 不 可 预期 的 、 令 人 难以 理解 的 行为 。 





















































1.3.5 ”JAR 的 弱 封 装 


Java 的 访问 修饰 符 很 适合 实现 对 同一 个 包 下 不 同类 的 封装 。 但 是 , 若 跨 越 包 的 边界 ， 则 类 型 
只 有 一 个 可 见 性 : 公有 。 

如 你 所 见 , 一 个 类 加 载 右 将 所 有 加 载 进 来 的 类 打包 成 一 个 “大 泥 球 ”( big ball of mud ),， 二 i 
得 出 “所 有 公有 类 对 所 有 其 他 类 可 见 ” 这 个 结论 。 受 限于 这 种 弱 封 装 ， 我 们 无 法 控制 JAR 的 可 
见 性 ， 使 某 些 功能 对 JAR 内 部 可 见 而 对 外 不 可 见 。 

这 导致 恰当 地 模块 化 一 个 系统 非常 困难 。 如 果 某 个 功能 对 所 在 模块 (比如 一 个 库 或 者 系统 的 
一 个 子 项 目 ) 的 不 同 部 件 而 言 都 是 必要 的 ,但 是 不 应 对 这 个 模块 外 部 可 见 , 那么 能 达到 这 个 目的 
的 唯一 办 法 是 将 它们 全 部 放 和 同一 个 包 中 ， 并 且 利 用 包 可 见 性 。 迫 不 得 已 ， 你 将 代码 结构 探 除 ， 
而 不 是 交 由 JVM 处 理 。 即 使 有 时 候 包 可 见 性 解决 了 这 个 问题 ， 反 射 也 可 以 破坏 此 规则 。 

弱 封 装 使 某 个 工件 的 客户 端 可 以 调用 内 部 代码 ， 如 图 1-10 所 示 。 如 果 IDE 建议 从 文档 标示 
为 内 部 使 用 的 包 中 导 和 人 类 ， 就 会 导致 这 种 意外 情况 。 更 常见 的 是 ,为 了 解决 一 些 似乎 没有 ( 有 时 
候 其 实 有 ) 更 佳 方案 的 问题 ， 人 们 会 故意 这 样 做 。 但 代价 非常 高 ! 
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从 概念 上 说 ， 在 company "Type 维护 者 不 期 望 你 使 用 JGitText: 但 是 在 类 路 径 中 ， 你 可 以 很 
和 internal.JGitText 之 间 有 它 是 一 个 公有 类 ,但 并 不 是 公有 容易 地 访问 JGitText 
一 个 界限 API 它们 之 间 没 有 界限 











company 
internal.JGitText [| | 
company. Type 











编译 时 依赖 在 编译 时 和 运行 时 








图 1-10 Eclipse JGit 的 维护 者 并 不 期 望 org.eclipse.jgit.internal 中 的 类 型 被 外 部 
使 用 。 但 不 幸 的 是 ， 由 于 Java 没有 JAR 内 部 访问 权限 的 概念 ， 因 此 它 的 维护 者 
无 法 阻止 com. company .Type 对 这 个 包 的 使 用 。 即 便 它 只 是 对 包 可 见 ， 也 可 以 
通过 反射 被 访问 
这 样 客 户 端 代码 与 依赖 工件 的 实现 细节 发 生 耦 合 , 让 客户 端 代码 的 升级 风险 非常 高 , 并 且 如 
果 维 护 者 不 得 不 考虑 这 种 耦合 ， 就 会 影响 对 内 部 代码 的 改动 。 这 将 减缓 甚至 阻止 该 工件 进行 有 意 
义 的 改进 。 
虽然 可 能 听 上 去 这 像 是 一 个 极端 问题 ， 但 其 实 不 是 。 最 臭名 昭著 的 例子 是 sun.misc. 
Unsafe， 即 一 个 JDK 内 部 类 , 它 使 人 们 可 以 (根据 Java 标 准 ) 做 一 些 疯狂 的 事情 ， 比 如 直接 分 
配 和 释放 内 存 。Netty、PowerMock、Neo4J] 、Apache Hadoop 和 Hazelcast 等 主流 Java 库 和 框架 使 
用 了 它 。 因 为 许多 应 用 程序 依赖 这 些 类 库 ， 所 以 也 就 依赖 了 这 些 内 部 代码 。 因 此 ，Unsafe 类 成 
了 Java 基础 架构 的 一 个 关键 部 分 ， 即 便 这 样 违背 了 其 设计 初衷。 
另外 一 个 例子 是 JUnit 4。 很 多 工具 ， 尤 其 是 IDE， 有 很 多 很 好 的 特性 ， 可 以 帮助 开发 者 简化 
测试 。 但 是 由 于 JUnit4 的 API 不够 丰富 , 不 足以 用 来 实现 所 有 特性 ， 因 此 这 些 工具 不 得 不 调用 其 
内 部 代码 。 这 种 耦合 极 大 地 延缓 了 JUnit 4 的 开发 , 并 最 终 成 为 JUnit 5 完全 重 写 的 一 个 重要 原因 。 


1.3.6 ”手动 安全 检查 


包 边 界 的 弱 封 装 导致 的 一 个 直接 后 果 是 , 与 安全 相关 的 功能 被 暴露 给 运行 在 同一 个 环境 中 的 
所 有 代码 。 这 意味 着 恶意 代码 可 以 访问 关键 功能 ， 且 唯一 的 解决 方法 是 在 关键 执行 路 径 中 进行 手 
动 安全 检查 。 

从 Java 1.1 开始 ， 安 全 检查 通过 在 每 一 个 与 安全 相关 的 代码 路 径 上 调用 securityManager:: 
checkPackageAccess 来 实现 ， 该 函数 用 于 检查 调用 者 是 否 有 权限 访问 ， 或 者 说 ， 它 必须 在 这 
样 的 代码 路 径 上 被 调用 。 在 过 去 ,忘记 这 些 检查 导致 了 一 些 代码 漏洞 ,结果 Java 安全 问题 像 “ 冶 
疫 ” 一 样 传播 , 在 Java 7 向 Java 8 过 渡 的 过 程 中 尤为 如 此 。 
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理所当然 地 会 有 人 认为 ,与 安全 相关 的 代码 需要 反复 检查 。 但 是 凡人 和 皆 会 犯错 ， 且 相 较 于 自 
动 化 检查 ， 手 动 在 模块 边界 中 择 入 安全 检查 风险 更 高 。 


1.3.7 ” 较 差 的 启动 性 能 


你 是 否 思 考 过 : 为 什么 很 多 Java 应 用 程序 , 尤其 是 使 用 像 Spring 一 样 强大 框架 的 Web 程序 ， 
需要 加 载 这 么 久 ? 



































定义 : 慢 启 动 

如 前 文 所 述 ，JVM 会 惰性 地 加 载 需要 的 类 。 更 普遍 的 是 ， 很 多 类 会 在 启动 过 程 中 被 立即 
访问 〈 与 此 相对 的 是 在 应 用 程序 运行 一 段 时 间 后 再 被 访问 )， 并且 Java 在 运行 时 需要 很 长 的 时 
间 将 它们 全 部 加 载 。 





其 中 一 个 原因 是 ， 类 加 载 咒 没 办 法 知道 某 个 类 来 自 于 哪个 JAR， 所 以 它 必 须 对 类 路 径 中 
的 所 有 JAR 执行 一 次 线性 扫描 。 类 似 地 ， 要 识别 某 个 注解 的 所 有 使 用 ， 需 要 检查 类 路 径 中 的 
所 有 类 。 





1.3.8 死板 的 Java 运 行 时 环境 


这 确实 不 是 JVM“ 大 泥 球 ” 著 的 祸 ,但 是 随 着 对 问题 讨论 的 逐步 深入 ， 本 书 最 终 会 谈 及 它 。 




















定义 : 死板 的 运行 时 环境 
在 Java8 之 前 ， 人 们 无 法 安装 Java 运行 时 环境 (JRE) 的 一 个 子 集 。 所 有 的 Java 安装 都 
有 一 些 不 必要 的 功能 ， 比 如 支持 XML 、SQL 和 Swing。 


尽管 这 可 能 对 中 型 计算 设备 ( 比如 个 人 台式 计算 机 和 笔记 本 计算 机 ) 影响 不 大 , 但 对 于 路 由 
器 、 电 视 机 机 顶 盒 、 车 载 计算 机 ， 以 及 其 他 任何 使 用 Java 的 小 型 设备 异常 重要 。 随 着 目前 的 容 
器 化 趋势 ， 此 问题 对 服务 器 也 产生 了 影响 ， 因 为 减少 容器 镜像 的 资源 占用 可 以 降低 运营 成 本 。 

Java 8 引入 了 紧凑 配置 文件 (compact profile )， 定 义 了 Java 标准 版 ( Java SE ) 的 3 个 子 集 ， 
虽 缓 解 了 这 个 问题 ,但 并 没有 完全 解决 。 紧 凑 配 置 文件 是 固定 的 ,无 法 满足 当前 和 未 来 所 有 对 部 
分 JRE 的 需求 。 


1.4 “” 乌 了 晤 模块 系统 


前 文 只 讨论 了 为 数 不 多 的 问题 。 然 而 Java 模块 系统 是 如 何 解 决 它们 的 ?主要 原理 其 实 非 常 
简单 。 
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要 局 模块 是 Java 平台 模块 系统 (JPMS ) 的 基石 。 像 JAR 一 样 ， 它 们 是 类 型 和 
资源 的 容器 ， 但 相 比 JAR， 它 们 还 具有 额外 的 特性 。 以 下 是 最 基本 的 特性 

口 名 称 最 好 全 局 唯一 ; 

口 对 其 他 模块 的 依赖 声明 ; 

口 一 个 由 导出 包 构 成 的 明确 声明 的 API。 








一 切 皆 模块 


模块 有 很 多 种 类 ，3.1.4 节 对 它们 进行 了 总 结 和 分 类 ， 但 现在 有 必要 对 它们 进行 一 次 快速 概 
览 。 在 Jigsaw 项 目 中 ，OpenJDK 被 分 成 了 大 约 100 个 模块 ， 即 所 谓 的 平台 模块 ， 其 中 有 30 个 左 
右 以 java.* 命 名 ， 它 们 是 每 一 个 JVM 都 必须 包含 的 标准 化 模块 ( 图 1-11 展示 了 其 中 一 部 分 )。 
这 不 仅 是 一 个 概念 图 ， 更 是 模块 系统 实际 看 待 事物 的 方式 



















java.management.rmi 





javasauoweet | java.xml.crypto | 


java.security.sasl 


java.security.jgss 








java.management java.prefs 











vy J vv 
人 aas 下 java.naming ( java.logging }( java.xml | 








javadatatranster| ( java.compiler | (ramsment | | java.rmi | 


























图 1-11 平台 模块 的 一 个 节选 。 箭头 展示 了 它们 之 间 的 依赖 关系 (为 了 让 图 简略 而 省 略 了 一 
部 分 ): 育 合 器 模块 java.se 直接 依赖 于 图 中 各 模块 ， 而 各 模块 直接 依赖 于 java.base 











下 面 是 其 中 一 些 比较 重要 的 模块 。 
口 java.base 一 一 没有 这 个 模块 ，JVM 就 无 法 实现 程序 功能 。 包 含 像 java.1lang 和 
java.util 这 样 的 包 。 








些 华丽 桌面 UI 的 开发 者 所 用 。 包 含 Abstract Window Toolkit 
(AWT; java.awt.x* 凶 、Swing (javax.swing.* 包 ) 以 及 其 他 的 API， 比 如 JavaBeans 
(java.beans.* 凶 。 

口 java.logging 一 一 包含 java .util.logging 包 。 

口 java.rmi 一 一 远程 方法 调用 ( RMI )。 

口 java.xml 一 一 包含 大 部 分 XML API: Java API for XML Processing ( JAXP )、Streaming API 

for XML (StAX )、Simple API for XML (SAX ) 以 及 文档 对 象 模型 ( DOM )。 

DQ java.xml.bind——Java Architecture for XML Binding ( JAXB )。 
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D java.sq| 一 一 Java 数据 库 连 接 (JDBC )。 
口 java.sql.rowset 一 一 JDBC RowSet API。 
Djava.se 一 一 此 模块 引用 了 构成 核心 Java 标准 版 API 的 众多 模块 ( 所 谓 的 聚合 器 模块 ， 参 
见 11.1.5 欧 。 
口 java.se.ee 
志 。 

接 下 来 是 JavaFX。 在 高 级 别 架 构 上 , 它 比 AWT 和 Swing 更 先进 , 一 个 表征 是 , 它 不 光 从 JDK 
解 看 分离， 实际 上 还 分 成 了 7 个 模块 : 绑 定 、 绘 图 、 控 制 、 网 络 视图 、FXML、 媒 体 以 及 Swing 
交互 操作 。 所 有 这 些 模块 的 名 称 均 以 javafx.* 开 头 。 

最 后 ， 有 大 约 60 个 以 jak 作为 前 缀 命名 的 模块 。 它 们 包含 API 实现 、 内 部 功能 实现 、 工 具 
[ 比如 编译 器 、JAR 、Java 依赖 分 析 工 具 (JDeps ) 和 Java 脚本 工具 (JShell ) ]， 等 等 。 它 们 在 各 
个 JVM 中 可 能 有 不 同 的 实现 ， 因 此 使 用 这 些 模块 如 同 使 用 sun . 包 一 样 并 不 是 有 前 瞻 性 的 选择 ， 
有 时 却 不 得 已 而 为 之 。 

可 以 执行 java --1list-modules 列 出 JDK 或 JRE 中 所 有 的 模块 。 如 果 想 查看 某 一 个 模块 
的 细节 ， 则 可 以 执行 java --describe-module s{module-name}。(s{module-name} 是 一 
个 占 位 符 ， 并 不 是 有 效 的 语法 ， 需 要 用 你 选择 的 模块 名 来 蔡 换 。) 

平台 模块 被 打包 进 JMOD 文件 ， 一 个 专门 用 来 完成 此 任务 的 新 的 文件 格式 。 但 是 JDK 之 外 
的 代码 也 可 以 创建 模块 。 在 这 种 情况 下 ， 它 们 是 模块 化 JAR， 即 一 个 简单 的 JAR 附加 了 一 个 新 
的 结构 一 一 模块 描述 符 。 模块 描述 符 定 义 了 模块 名 、 依赖 以 及 导出 。 基 于 带 有 模块 描述 符 的 JAR， 
最 终 由 模块 系统 创建 模块 。 


要 点 这 构成 了 模块 系统 的 一 个 基本 要 素 : 一 切 皆 模块 ! (或 者 更 精确 地 说 ， 不 
论 类 型 和 资源 如 何 呈 现 给 编译 器 或 虚拟 机 ， 它 们 最 终 都 会 被 转换 成 模块 。) 模块 
是 模块 系统 的 核心 , 因此 也 是 本 书 的 核心 。 任 何其 他 事物 最 终 都 会 被 追溯 回 模块 、 
模块 名 、 模 块 依赖 声明 ， 以 及 模块 导出 的 API。 











此 模块 引用 了 构成 完整 Java 标准 版 API 的 众多 模块 (另外 一 个 聚合 器 模 






































1.5 你 的 第 一 个 模块 
JDK 被 模块 化 后 看 上 去 很 不 错 ， 但 你 自己 的 代码 呢 ? 如 何 将 之 模块 化 ? 这 是 个 非常 简单 的 


问题 。 
唯一 要 做 的 ， 就 是 在 源 代码 目录 中 增加 一 个 名 为 module-info.java 的 文件 作为 模块 声明 ， 并 
且 在 其 中 填 入 模块 名 、 对 其 他 模块 的 依赖 ， 以 及 组 成 公有 API 的 包 。 


module my.xml.app { 
requires java.base; 
requires java.xml; 

















后 续 将 看 到 java.base 
不 是 必要 的 


exports my .xml.api; 
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看 上 去 my.xml.app 模 块 使 用 了 平台 模块 java.base 和 java.xml, 并 且 导 出 了 com.example.xml 
包 。 到 目前 为 止 一 切 顺利 。 现 在 将 module-info.java 与 其 他 源 代码 一 起 编译 成 .class 文件 并 且 打 包 








进 一 个 JAR( 编译 右 和 jar 工具 会 自动 地 正确 处 理 它们 )。 非 常 好 ， 你 已 

















1.5.1 模块 系统 实战 





要 启动 XML 应 用 程序 并 观察 模块 系统 的 运转 ， 可 以 执行 如 下 命令 


java 
--module-path mods 
--modqule my.xml .app 


模块 系统 从 此 处 开始 接管 
困境 。 

(1) 自 启动 。 

(2) 验证 所 需 的 模块 都 存在 

(3) 构建 应 用 程序 架构 的 内 部 描述 。 

(4) 启动 初始 模块 的 main 函数 。 

(5) 在 应 用 程序 执行 过 程 中 持续 运行 以 保护 模块 内 部 。 
图 1-12 包含 了 所 有 步骤 。 但 是 请 不 要 冒进 ， 而 要 逐个 理解 它们 。 

















JREMNDKE 中 的 模块 





经 创建 了 第 一 个 模块 。 


〇 


。 它 需 要 采取 如 下 步 又 来 摆脱 你 在 1.2 市 和 1.3 节 所 看 到 的 “大 泥 球 ” 





基础 模块 包含 所 有 重要 的 类 ， 模块 路 径 中 的 模块 
















其 中 包括 模块 系统 


(平台 模块 ) 


(应 用 程序 模块 ) 


| 程 



















JPMS 利 用 模块 图 来 呈现 | 上 


应 用 程序 的 架构 


Se 


Ss oS 
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module my.xml.app { 


requires java.base; 
requires java.xml; 
exports my.xml.api; 








> 
| 习 JPMS 验 证 所 需 模 块 


my.xml.app 








是 否 存在 及 其 可 靠 性 ， 
JPMS 并 构建 模块 区 




















1 JVM 引 导 启 动 
模块 和 模块 系统 


-个 模块 是 否 可 以 访问 另 一 个 
顶 块 的 类 型 ， 取 决 于 它们 在 
模块 图 中 的 连接 以 及 第 二 个 
模块 的 导出 








图 1-12 运行 中 的 Java 平台 模块 系统 。 在 启动 过 程 中 它 完 
2 
中 的 应 ) 























程序 。 在 运行 时 ， 











java.xml 上 java.base 






39 JPMS 启 动 初始 模块 的 main 


有 JPMS 强 制 规 定 了 模块 间 
的 界限 ， 并 (在 应 用 程序 
运行 的 财 候 ) 对 非法 访 1 
抛 出 错误 


运行 的 时 候 ) 对 非法 访问 


成 了 大 多 数 工作 ， 在 全 启动 
它 加 在 构建 模块 图 时 确保 所 有 模块 都 存在 ， 此 后 图 将 控制 权 交 给 
它 国 强 制 保护 每 个 模块 的 内 部 


全 运行 
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1. 加 载 基础 模块 

模块 系统 只 是 代码 ， 并 且 前 文 提 到 一 切 丝 模块， 那么 哪 一 个 包含 了 JPMS? 答案 是 基础 模块 
java.base。 像 “ 鸡 生 重重 生 鸡 ”问题 一 样 ， 模 块 系统 和 基础 模块 相互 引导 启动 。 

基础 模块 也 是 JPMS 构建 的 模块 图 的 第 一 个 节点 。 这 就 是 下 面 要 做 的 事情 。 


2. 模块 解析 : 构建 一 个 描绘 应 用 程序 的 图 

你 输入 的 命令 以 --module my .xml .app 结尾 ， 它 会 告诉 模块 系统 my.xml.app 是 应 用 程序 
的 主要 模块 并 且 模 块 解析 需要 从 这 里 开始 。 但 是 JPMS 在 哪儿 能 找到 这 个 模块 呢 ? 这 正 是 
--module-path mods 大 展 身手 的 地 方 , 它 可 以 告诉 模块 系统 , 应 该 在 mods 目录 中 找 应 用 程序 
模块 ， 这 样 卫 MS 会 尽责 地 从 那里 寻找 my.xml.app 模块 。 

但 是 日 录 并 不 包含 模块 ,它们 只 包含 JAR。 所 以 模块 系统 扫描 mods 目录 中 的 所 有 JAR 并 且 
寻找 它们 的 模块 描述 符 。 此 例 中 ，mods 目录 包含 my .xml .app.jar， 并且 它 的 描述 声称 其 包含 
名 为 my.xml.app 的 模块 。 这 就 是 模块 系统 一 直 在 寻找 的 东西 ! JPMS 创建 了 my.xml.app 的 一 个 内 
部 描述 并 且 将 之 添加 到 模块 图 中 一 一 到 目前 为 止 ， 它 还 没有 和 任何 其 他 事物 产生 关联 。 

模块 系统 找到 了 初始 模块 ,下 一 步 是 什么 ”搜索 依赖 ,my.xml.app 的 描述 符 声明 它 需 要 java.base 
和 java.xml 模 块 ，JPMS 又 如 何 找 到 它们 呢 ? 

首先 ，java.base 模块 是 已 知 的 ， 所 以 模块 系统 可 以 在 my.xml.app 和 java.base 之 间 添 加 一 个 
连接 ， 即 模块 图 中 的 第 一 条 边 。 接 下 来 是 java.xml 模 块 。 它 的 第 一 个 单词 是 java， 这 就 告诉 模块 
系统 它 是 一 个 Java 平 台 模 块 ， 所 以 JPMS 不 会 在 模块 路 径 中 寻找 它 ， 而 是 会 搜索 模块 仓库 。 找 到 
java.xml 模块 后 ，JPMS 会 将 其 添加 到 模块 图 中 ， 并 将 my.xml.app 与 之 连接 。 

现在 模块 图 中 有 3 个 节点 , 但 只 解析 了 两 个 , java.xml 模块 的 依赖 关系 仍旧 不 明 , 因此 JPMS 
将 继续 寻找 这 些 依赖 关系 。 在 发 现 java.xml 仪 依赖 于 java.base 后 ， 模 块 解析 的 工作 完成 。 从 
my.xml.app 和 无 所 不 在 的 基础 模块 开始 ， 这 个 过 程 构建 了 一 个 具有 3 个 节点 的 局 部 模块 图 。 

如 果 JPMS 找 不 到 所 需 的 模块 ， 或 者 遇 到 任何 卜 义 ( 比如 两 个 包含 同名 模块 的 JAR )， 它 将 
退出 并 提供 错误 信息 。 这 意味 着 人 们 可 以 在 启动 时 就 发 现 问题 ,从 而 避免 在 将 来 应 用 程序 运行 中 
的 任意 时 间 点 出 现 错误 ， 导 致 应 用 程序 月 省。 


3. 启动 初始 模块 

回想 一 下 这 个 过 程 是 如 何 开始 的 ? 是 的 ， 输 入 以 --modqule my .xml.app 结尾 的 命令 。 接 
着 模块 系统 完成 它 的 核心 功能 之 一 一 一 验证 所 有 必需 的 依赖 是 否 存 在 ， 然 后 将 控制 权 移交 给 应 
用 程序 。 

初始 模块 my.xml.app 不 仅 是 模块 解析 的 起 点 ， 还 必须 包含 main (public static void 
main (String[]) ) 函数 。 但 是 在 启动 应 用 程序 时 ， 不 一 定 需 要 指定 包含 该 方法 的 类 。 此 处 不 指 
定 是 因为 在 将 类 ( .class ) 文件 打包 成 JAR 的 时 候 已 经 指定 好 了 该 主 类 的 位 置 。 这 一 信息 被 谍 人 
至 模块 描述 符 中 ， 这 样 JPMS 就 可 以 对 它 进 行 读 取 了 。 
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由 于 使 用 了 --module my .xml .app 但 未 指定 主 类 , 因此 模块 系统 希望 在 模块 描述 符 中 找到 
该 信息 。 幸 好 ， 它 找到 了 主 类 并 在 其 上 调用 了 main 函数 。 应 用 程序 启动 了 ,但 是 JPMS 的 工作 
还 未 结束 。 


4. 保护 模块 内 部 

即使 应 用 程序 启动 成 功 , 模块 系统 也 需要 持续 运行 ， 以 实现 其 第 二 个 基本 功能 : 保护 模块 内 
部 。 还 记得 my.xml.app 的 模块 声明 中 的 exports my .xml .api 吗 ? 这 一 行 及 其 类 似 的 内 容 就 是 
该 功能 发 挥 作 用 的 地 方 。 

每 当 一 个 模块 首次 访问 另外 一 个 模块 中 的 类 型 时 ，JPMS 就 会 验证 以 下 3 个 条 件 是 否 满足 。 
口 被 访问 的 类 型 必须 是 公有 的 ( public )。 
口 拥有 该 类 型 的 模块 必须 已 导出 对 应 的 包 。 
口 在 模块 图 中 ,访问 模块 必须 连接 到 被 调用 模块 。 

所 以 当 myxmlapp 模 块 首次 使 用 javax.xml .XMLConstants 时 ,模块 系统 将 检查 XMLCconstants 
是 否 是 公有 的 (NN )、java.xml 模 块 是 否 导出 javax.xml 包 (VY)， 以 及 在 模块 图 中 my.xml.app 是 
否 已 连接 到 java.xml ( V )。 三 者 都 检查 通过 后 ，my.xml.app 才能 使 用 xMLConstants。 

这 种 验证 方式 弥补 了 之 前 讨论 的 “大 泥 球 ”方法 的 严重 缺陷 : 无 法 区 分 工件 内 部 的 代码 与 可 
公开 使 用 的 代码 。 有 了 exports 关键 字 ， 模 块 就 可 以 清晰 地 定义 哪些 API 是 公有 的 ， 哪 些 是 内 
部 的 ， 并 且 可 以 依赖 模块 系统 来 保证 这 些 选 择 得 以 实现 。 


5. 一 个 更 复杂 的 示例 

作为 一 个 并 不 简单 的 示例 ， 图 1-13 展示 了 1.2 节 介 绍 的 ServiceMonitor 应 用 程序 的 模块 图 。 
它 包含 4 个 JAR 一 一 monitor、observer、statistics 和 persistence， 以 及 两 个 依赖 模块 一 一 spark 
和 hibernate。java.xml 和 java.base 等 JDK 模块 也 清晰 可 见 ， 因 为 应 用 程序 也 依赖 于 其 中 的 一 些 
模块 。 
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与 JavaSE 的 模块 图 一 样 ， 这 不 仅 应 用 程序 代码 的 模块 
是 一 个 概念 图 ， 更 是 模块 系统 对 
应 用 程序 的 呈现 


作为 依赖 的 persistence monitor Observer 
模块 monitor.persistence 
monitor.persistence.dtos eno onl ob ny 


hibernate 


org.hibernate 
org.hibernate.cfg 
org.hibernate.mapping monitor.statistics 

























spark statistics 






spark 
spark.ssl 























人 
java.base 
java.lang ” 
java.util , 


em Java 模 块 


更 多 依赖 
1-13 ServiceMonitor 应 用 程序 的 模块 图 非常 类 似 于 图 1-6 中 的 体系 结构 图 。 该 图 显示 

















了 包含 应 用 程序 代码 的 4 个 模块 、 用 于 实现 其 功能 集 的 两 个 库 以 及 JDK 中 涉及 
的 模块 。 箭 头 描 绘 了 它们 之 间 的 依赖 关系 。 每 个 模块 仅 列 出 了 一 部 分 导出 包 





图 1-13 与 图 1-6 的 对 比 非常 引 人 注 目 , 图 1-6 描绘 的 是 ServiceMonitor 的 JAR 文件 间 的 依赖 
关系 ， 展 示 了 我 们 对 如 何在 工件 级 别 上 组 织 应 用 程序 的 理解 ， 而 图 1-13 展示 了 如 何 从 模块 系统 角 
度 看 竺 应 用 程序 。 它 们 非常 相似 ， 这 表明 模块 系统 可 以 很 好 地 表达 应 用 程序 的 体系 结构 。 




















1.5.2” 非 模块 化 项 目 基本 不 受 影响 


现 有 项 目 (尤其 是 具有 大 型 代码 库 的 项 目 ) 的 开发 人 员 ， 可 能 对 迁移 路 径 感 兴趣 。 虽然 在 其 
他 模块 系统 中 , 迁移 通常 意味 着 “要 么 全 盘 接受 ， 要么 彻底 放弃 ”一 一 为 了 能 够 使 用 ,一 切 都 必 
须 是 模块 ， 但 是 在 JPMS 中 情况 有 所 不 同 。 为 了 保持 向 后 兼容 性 ， 在 Java 8 或 更 早 版 本 的 类 路 径 
上 运行 的 常规 应 用 程序 , 在 Java9 上 的 行为 必须 一 致 。 因 此 ， 非 模块 化 的 应 用 程序 必须 能 在 模块 
化 JDK 之 上 运行 , 这 意味 着 模块 系统 必须 处 理 这 样 的 情况 。 

事实 确实 如 此 。 前 文 提 到 模块 系统 能 处 理 尚 未 转化 为 模块 的 JAR， 这 正 是 因为 向 后 兼容 性 。 
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虽然 迁移 到 模块 系统 是 有 益 的 ， 但 这 不 是 强制 性 的 。 

因此 ， 类 路 径 的 工作 方式 仍然 与 在 Java 8 或 更 早 版 本 中 相同 ， 它 可 以 用 来 为 编译 融和 JVM 
指定 JAR 或 普通 类 文件 。 就 连 类 路 径 上 的 模块 也 会 像 非 模块 化 JAR 一 样 运行 。 这 里 的 基本 假设 
是 ， 类 路 径 机 制 负责 访问 “大 泥 球 ”内 的 工件 ， 正 如 1.3 节 所 述 。 

与 此 同时 ,一 个 新 的 概念 诞生 了 : 模块 路 径 (module path )。 这 里 的 基本 假设 是 将 所 有 工件 
视 为 模块 。 有 趣 的 是 ， 即 使 是 对 普通 的 JAR 也 是 如 此 。 


要 点 类 路 径 和 模块 路 径 的 共存 以 及 它们 对 普通 工件 和 模块 化 工件 的 不 同 处 理 
方式 ， 是 大 型 应 用 程序 向 模块 系统 逐渐 迁移 的 关键 。 第 8 章 将 深入 探讨 这 个 重要 
的 主题 。 


另 一 个 对 于 模块 系统 ， 尤 其 是 遗留 项 目 而 言 十 分 重要 的 方面 ， 就 是 兼容 性 。JPMS 的 诞生 涉 
及 大 量 底层 修改 ， 虽 然 绝 大 多 数 修改 严格 保持 向 后 兼容 ， 但 有 些 与 现 有 代码 库 的 交互 很 糟糕 。 
口 对 JDK 内 部 API 的 依赖 ( 比如 引用 sun.* 包 ) 将 会 导致 编译 时 错误 或 运行 时 警告 。 
口 JEE 的 API 必须 手动 解析 。 
口 不 同 工 件 下 相同 包 中 的 类 会 造成 问题 。 
口 紧凑 配置 文件 、 扩 展 机 制 、 授 权 标 准 覆 盖 机 制 以 及 类 似 功能 已 被 删除 。 
口 运行 时 图 像 布局 发 生 了 显著 的 改变 。 
口 应 用 程序 的 类 加 载 右 不 再 是 URLCl1assLoader。 
最 后 ,无 论 应 用 程序 是 否 模块 化 ， 在 Java 9 或 更 高 版 本 上 运行 都 有 可 能 出 现 问题 。 第 6 章 和 
第 7 章 将 致力 于 识别 和 克服 这 些 最 常见 的 挑战 。 
此 时 ， 你 可 能 会 有 下 列 疑 问 。 
口 Maven 、Gradle 以 及 其 他 类 似 软件 不 是 已 经 管理 好 依赖 关系 了 吗 ? 
口 开放 服务 网 关 协 议 (Open Service Gateway Initiative，OSGi ) 呢 ? 为 什么 不 直接 用 它 ? 
口 在 微服 务 普遍 流行 的 时 代 ， 模 块 系统 是 否 矫 枉 过 正 ? 
提出 这 些 疑 问 是 正确 的 。 没 有 任何 技术 是 一 座 孤 岛 ， 而 将 整个 Java 生态 系统 看 作 一 个 整体 ， 
研究 现 有 工具 和 方法 与 模块 系统 的 关系 以 及 它们 的 未 来 , 是 非常 值得 的 。15.3 节 会 探讨 这 个 话题 。 
既然 你 已 经 知道 了 理解 它 所 需要 的 一 切 , 仍 不 能 放 过 这 些 问 题 , 为 什么 不 现在 就 翻 到 那 一 节 呢 ? 
1.6 节 将 描述 模块 系统 想 要 实现 的 总 体 目 标 。 第 2 章 会 用 一 个 较 长 的 示例 展示 模块 化 应 用 程 
序 的 大 致 模样 。 第 3 章 、 第 4 章 和 第 5 章 将 详细 探讨 如 何 从 头 开始 编写 、 编 译 、 打 包 和 运行 此 类 
应 用 程序 。 本 书 第 二 部 分 会 讨论 兼容 性 和 迁移 的 话题 ， 第 三 部 分 则 介绍 模块 系统 的 高 级 特性 。 


1.6 ”模块 系统 的 目标 


本 质 上 ， 开 发 Java 平台 模块 系统 是 为 了 让 Java 掌握 工件 之 间 的 依赖 关系 图 。 其 思想 是 ， 如 
果 Java 不 再 擦 除 模块 结构 ， 那 么 擦 除 带 来 的 丑陋 结果 也 会 自动 消失 。 
首先 也 是 最 重要 的 ,这 应 该 可 以 缓解 现状 造成 的 许多 痛 点 。 但 除 此 之 外 , 它 为 大 多 数 未 使 用 



















































































































































































1.6 ”模块 系统 的 目标 23 








过 其 他 模块 系统 的 开发 人 员 提 供 了 新 的 能 力 , 即 可 以 进一步 提高 软件 的 模块 化 。 这 有 具体 意味 着 什 
呢 ? 
在 讨论 这 个 问题 之 前 , 首先 要 注意 , 模块 系统 的 所 有 目标 对 于 所 有 类 型 的 项 目 而 言 并 非 同等 
重要 。 许 多 目标 让 大 型 长 期 项 目 〈 比 如 JDK ) 收益 颇 丰 ，JPMS 也 主要 是 为 此 开发 的 。 模 块 系统 
的 大 多 数目 标 不 会 对 日 常 编码 产生 巨大 影响 , 远 不 如 Java 8 中 的 lambda 表 达 式 和 Java 10 中 的 var 
的 影响 大 。 但是, 这 些 目标 将 改变 项 目的 开发 和 部 署 方式 一 一 开发 和 部 署 也 是 我 们 每 天 都 在 做 的 
事情 之 一 。 
在 模块 系统 的 目标 中 ， 有 两 个 尤为 重要 : 可 靠 配 置 和 强 封装 。 相 比 其 他 目标 ， 本 书 将 重点 关 
注 这 两 方面 。 
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1.6.1 可靠 配 置 ， 不 放 过 一 个 JAR 


在 1.5.1 节 中 观察 模块 系统 如 何 工 作 时 ， 我 们 发 现 各 个 模块 会 各 自 声 明 对 其 他 模块 的 依赖 ， 
而 JPMS 会 分 析 这 些 依赖 关系 。 虽 然 我 们 只 学 习 了 JVM 启动 的 案例 ， 但 是 编译 时 和 链接 时 都 有 
相同 的 工作 机 制 ( 这 是 新 的 内 容 ， 参见 第 14 章 )。 因 此 ， 当 发 现 依赖 缺失 或 冲突 时 ， 这 些 操作 会 
快速 失败 。 事 实 上 ,在 启动 时 就 可 以 发 现 缺少 哪些 依赖 ， 相 比 当 第 一 次 需要 类 时 才 发 现 ,这 是 一 
个 巨大 的 进步 。 

在 Java 9 之 前 ， 包 含 同 名 类 的 不 同 JAR 不 会 被 识别 为 冲突 。 相 反 ， 运 行 时 会 任意 选择 其 中 
的 一 个 类 来 执行 ， 以 覆盖 其 他 同名 类 ， 这 导致 了 1.3.2 节 描 述 的 复杂 性 问题 。 从 Java 9 开始 ， 编 
译 嚣 和 JVM 能 够 识别 出 这 一 问题 以 及 之 前 版 本 中 导致 指 意 不 明 的 其 他 问题 。 





































































































定义 : 可 靠 配置 

总 之 , 这 使 系统 的 配置 比 以 前 更 加 可 靠 , 因为 只 有 符合 语法 规则 的 配置 才能 通过 启动 时 的 
相关 检查 。 检 查 通过 后 ，JVM 就 可 以 将 依赖 关系 图 转化 为 模块 图 ， 从 而 用 结构 良好 的 系统 运 
行 图 来 代替 过 去 的 “大 泥 球 ” 了 ， 这 就 是 我 们 将 拥有 的 可 靠 性 。 


1.6.2 ” 强 封 装 : 控制 模块 内 部 代码 的 访问 权限 

模块 系统 的 另外 一 个 关键 目标 就 是 赋予 模块 强 封装 性 : 控制 模块 内 部 的 访问 权限 , 仅 允 许 访 
问 指定 的 内 容 。 

模块 系统 中 的 私有 类 应 该 像 类 中 的 私有 成 员 一 样 。 换 言 之 , 模块 之 间 的 边界 不 仅 决 

定 了 类 和 接口 的 可 见 性 ， 还 决定 了 访问 权限 。 
Mark Reinhold, Project Jigsaw: Bringing the Big Picture into Focus 

为 了 实现 上 述 目标 ， 编 译 需 和 JVM 都 严格 执行 模块 间 的 访问 规则 : 只 人 允许 访问 导出 包 中 公 
有 类 型 的 公有 成 员 ( 即 公有 的 字段 和 方法 )。 其 他 类 型 无 法 被 模块 外 的 代码 访问 ， 即 使 通过 反射 
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机 制 也 不 行 。 由 此 , 我 们 最 终 对 依赖 库 内 部 的 信息 进行 了 强 封 装 ， 并 确保 应 用 程序 不 会 意外 地 依 
赖 于 实现 细节 。 

这 也 同样 适用 于 JDK。 如 上 一 节 所 述 ， 它 已 经 被 模块 化 ， 因 此 ， 模 块 系统 会 阻止 对 JDK 内 
部 API 的 访问 ， 也 就 是 以 sun .或 com. sun .开头 的 一 些 包 。 不 幸 的 是 ,许多 广泛 使 用 的 框架 或 
者 类 库 ， 比 如 Spring、Hibernate 和 Mockito， 使 用 了 这 些 内 部 API， 因 此 如 果 模 块 系统 严格 维持 
这 一 行为 ,那么 很 多 应 用 程序 在 Java 9 上 将 无 法 运行 。 为 了 让 开发 人 员 有 时 间 进 行 迁移 ，Java 设 
置 了 宽松 的 条 件 : 编译 器 和 JVM 提供 了 命令 行 开关 , 用 于 访问 内 部 API, 并 且 在 Java9 到 Java 11 
中 ， 这 一 开关 在 默认 情况 下 是 打开 的 (更 多 内 容 参 见 7.1 欧 。 

为 了 防止 代码 意外 地 依赖 于 间接 依赖 关系 中 的 类 型 ,导致 多 次 运行 的 行为 不 一 致 ， 这 种 情况 
下 更 为 严格 : 通常 ， 一 个 模块 仅 能 访问 有 直接 依赖 关系 的 模块 中 的 类 型 ( 但 可 能 因为 某 些 高 级 特 
性 而 出 现 例外 )。 


1.6.3 自动 化 的 安全 性 和 改善 的 可 维护 性 


模块 内 部 API 的 强 封 装 可 以 极 大 地 提高 安全 性 和 可 维护 性 。 这 有 助 于 提升 安全 性 , 因为 关键 
代码 可 以 有 效 地 隐藏 在 不 需要 使 用 它 的 代码 之 外 。 同 时 ,这 使 得 维护 更 加 容易 ， 因 为 模块 的 公有 
API 可 以 很 容易 地 保持 较 小 的 规模 。 
随意 地 使 用 Java SE 平台 用 于 内 部 实现 的 API， 既 带 来 了 安全 风险 又 增加 了 维护 负 


担 。Java 新 版 本 规范 里 提供 的 强 封装 这 一 特性 ， 将 满足 让 Java SE 平台 控制 其 内 部 API 
访问 权限 的 需求 。 










































































Java Specification Request (JSR) 376 


1.6.4 ”改善 的 启动 性 能 
随 着 代码 的 边界 更 加 清晰 ， 可 以 更 有 效 地 利用 现 有 优化 技术 。 


当 已 知 一 个 类 只 能 引用 一 些 特定 部 件 中 的 类 而 不 是 运行 时 加 载 的 任何 类 时 ,许多 事 
前 的 优化 手段 会 更 加 有 效 。 
一 一 /SR 376 


另外 还 可 以 通过 注解 来 标明 特定 的 类 或 接口 , 以 便 在 没有 完整 类 路 径 扫描 的 情况 下 找到 对 应 
的 类 型 。 这 在 Java 9 中 尚未 实现 ， 但 可 能 会 在 将 来 的 某 个 版 本 中 实现 。 














1.6.5 “可 伸缩 的 Java 平 台 


具有 明确 定义 的 依赖 关系 的 模块 的 一 个 良好 结果 是 ， 很 容易 确定 JDK 的 运行 子 集 。 例 如 ， 
服务 器 端 应 用 程序 无 须 使 用 AWT、Swing 或 JavaFX， 就 可 以 轻松 地 在 没有 这 些 功能 的 JDK 上 运 
行 。 新 的 工具 jlink (参见 第 14 章 ) 使 创建 应 用 程序 运行 时 所 需 的 模块 关系 图 成 为 可 能 。 我 们 
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甚至 可 以 包含 库 和 应 用 程序 模块 ， 从 而 创建 一 个 不 需要 在 主机 系统 上 安装 Java 的 自 包含 程序 。 





定义 : 可 扩展 的 平台 
随 着 JDK 的 模块 化 ， 人 们 可 以 选择 需要 的 功能 并 创建 仅 包含 所 需 模块 的 JRE。 


这 一 特性 将 维持 Java 在 小 型 设备 和 应 用 程序 容器 中 的 关键 地 位 。 


1.6.6 非 目 标 


不 幸 的 是 , 模块 系统 并 非 “灵丹妙药 ”， 并 且 缺 失 了 几 个 有 趣 的 用 例 。 首先， JPMS 没有 版 本 
的 概念 。 人 们 不 能 为 模块 设置 版 本 或 要 求 其 必须 依赖 某 个 版 本 , 也 就 是 说 , 虽然 可 以 在 模块 描述 
符 中 伦 入 版 本 信息 并 使 用 反射 API 访 问 它 , 但 这 只 能 作为 开发 人 员 和 工具 的 元 信息 一 一 模块 系统 
并 不 处 理 它 。 

JPMS“ 看 不 到 ”版 本 意味 着 它 不 会 区 分 同一 模块 的 两 个 版 本 。 相 反 ， 为 了 实现 可 靠 配 置 ， 
它 会 将 这 种 情况 视 为 一 种 经 典 的 皮 义 语 境 一 一 同一 模块 出 现 两 次 一 一 因此 导致 编译 或 启动 失败 。 
关于 模块 版 本 的 更 多 信息 ， 请 参阅 第 13 章 。 

JPMS 并 没有 提供 从 中 心 仓库 搜索 、 下 载 或 者 发 布 模块 的 机 制 ， 因 为 现 有 构建 工具 已 经 很 好 
地 完成 了 这 一 任务 。 
JPMS 的 目标 也 不 包括 构建 动态 模块 图 。 在 动态 模块 图 中 ， 单 个 模块 工件 可 以 在 运行 时 动态 
显示 或 消失 。 但 是 ， 如 果 想 实现 也 是 有 可 能 的 。 可 以 基于 层 ( 参见 12.4 节 ) 这 一 高 级 特性 来 实 
现 这 样 的 系统 。 


1.7 ”新 旧 技 能 


前 文 已 经 描述 了 许多 承诺 ， 本 书 的 其 余部 分 将 详细 阐述 Java 平台 模块 系统 是 如 何 实现 它们 
的 。 但 不 要 误解 ， 这些 好 处 不 是 免费 的 ! 要 在 模块 系统 之 上 构建 应 用 程序 ， 你 必须 对 工件 和 依赖 
进行 比 之 前 更 深入 的 思考 , 并 将 这 些 想 法 转化 为 代码 。 某 些 之 前 运作 正常 的 事物 在 Java 9 上 不 再 
如 此 ， 而 且 使 用 某 些 新 框架 需要 付出 比 之 前 更 多 的 努力 。 

你 可 以 将 这 种 变化 近似 理解 为 ， 相 比 于 动态 类 型 语言 ， 静 态 强 类 型 语言 需要 做 更 多 的 工作 ， 
至 少 在 代码 层面 上 如 此 。 有 这 么 多 的 类 型 和 泛 型 ,难道 不 可 以 直接 使 用 object 对 象 , 然后 在 各 
处 进行 强制 类 型 转换 吗 ? 当然 可 以 这 么 做 , 但 你 愿意 仅仅 为 了 在 编写 代码 时 节省 一 些 脑 力 , 就 放 
弃 强 类 型 系统 提供 的 安全 性 吗 ? 你 肯定 不 愿意 。 


1.7.1 你 将 学 到 什么 


掌握 新 技能 是 必需 的 ! 幸好 ， 本 书 将 教 你 这 些 新 技能 。 当 你 读 完 本 书 , 掌握 了 各 章 介绍 的 技 
能 ,不论 新 的 还 是 已 有 的 应 用 程序 都 不 会 成 为 阻碍 。 
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第 一 部 分 ， 特别 是 第 3 章 至 第 5 章 , 介绍 了 模块 系统 的 基础 知识 。 除 了 实践 技能 ,为 了 让 你 
加 深 理解 ， 这 几 章 还 将 讲授 底层 的 机 制 。 之 后 ,你 将 能 够 通过 封装 模块 内 部 信息 和 导出 其 依赖 关 
系 来 描述 模块 以 及 它们 的 关系 。 使 用 javac、jar 和 java 命令 ,你 将 能 编译 、 打 包 、 运 行 模块 
和 由 它们 组 成 的 应 用 程序 。 

第 二 部 分 会 在 基础 知识 之 上 进行 扩展 , 涵盖 更 复杂 的 用 例 。 针 对 已 有 的 应 用 程序 ,你 将 能 够 
分 析 其 与 Java 9 至 Java 11 版 本 之 间 可 能 的 不 兼容 性 ， 并 使 用 新 特性 规划 将 其 迁移 到 模块 系统 的 
路 径 。 为 了 达到 这 个 目标 ,以 及 实现 不 那么 简单 直接 的 模块 关系 ,你 可 以 使 用 一 些 高 级 特性 ， 比 
如 合 规 导出 ( qualified export )、 开 族 漠 块 (open module )、 服务 以 及 扩展 的 反射 API, 俏 jlink 
工具 , 你 可 以 创建 精简 的 、 针 对 特定 用 例 进 行 优化 的 JRE, 或 者 创建 附带 自己 的 JRE 的 自 包 含 应 
用 程序 映像 。 最 后 ,你 将 看 到 更 大 的 图 景 , 包括 模块 系统 是 如 何 与 类 加 载 、 反 射 以 及 容器 进行 交 
互 的 。 













































































1.7.2 ”你 应 该 知道 些 什么 


在 技能 要 求 方面 ，JPMS 有 一 个 有 趣 的 特征 。 它 所 做 的 大 部 分 工作 是 全 新 的 ， 并 且 在 模块 声 
明 中 分 割 了 自己 的 语法 。 如 果 你 具备 基本 的 Java 技能 ， 那 么 学 习 它 相对 容易 。 因 此 ， 如 果 你 知 
道 代码 是 按照 类 型 、 包 以 及 ( 最 终 ) JAR 组 织 的 ， 知 道 访问 修饰 符 ( 特别 是 puplic ) 的 用 法 ， 
同时 也 知道 javac、jar 和 java 命令 的 功能 以 及 大 致 用 法 , 你 将 很 容易 理解 第 一 部 分 以 及 第 三 
部 分 中 的 一 些 高 级 特性 。 

但 是 要 真正 理解 模块 系统 所 解决 的 问题 以 及 它 提 出 的 解决 方案 , 仅 知 道 这 些 还 不 够 。 熟悉 以 
下 几 点 , 并 有 大 型 应 用 程序 的 开发 经 验 , 可 以 更 轻松 地 理解 模块 系统 各 个 特性 的 设计 初衷 及 其 优 
缺点 。 
口 JVM， 尤 其 是 类 加 载 器 的 工作 机 制 。 
口上 述 机 制造 成 的 麻烦 ( 想 想 JAR 地 狱 )。 
口 更 高 级 的 Java API， 比 如 服务 加 载 器 和 反射 API。 
口 构建 工具 ， 比 如 Maven 和 Gradle， 以 及 它们 是 如 何 构建 项 目的 。 
口 如 何 对 软件 系统 进行 模块 化 。 

个 人 再 见 多 识 广 ， 也 有 可 能 碰 到 知识 育 区 。 在 Java 这 样 巨 大 的 生态 系统 中 ， 这 是 很 自然 

的 ， 我 们 无 论 走 到 哪里 都 会 学 到 新 的 东西 〈 相 信 我 ， 关 于 这 一 点 我 有 经 验 )。 所 以 ， 永 远 不 要 形 
失信 心 ! 如 果 书 中 的 一 些 内 容 对 你 没有 帮助 ， 就 试 试 直接 读 代码 来 理解 吧 。 
是 时 候 开始 学 习 JPMS 的 基础 知识 了 。 建 议 你 继续 阅读 第 2 章 ， 它 与 第 一 部 分 的 其 余 内 容 息 
息 相关 ， 以 代码 的 形式 展示 了 如 何 定义 、 构 建 以 及 运行 模块 化 的 JAR。 该 章 还 介绍 了 贯穿 本 书 其 
余部 分 的 应 用 程序 示例 。 如 果 你 更 喜欢 先 学 习 基 础 理论 ， 则 可 以 跳 到 第 3 章 ， 其 中 讲授 了 模块 系 
统 的 基本 机 制 。 如 果 担 心 已 有 项 目 与 Java 9 的 兼容 性 ， 可 以 看 一 下 第 6 章 和 第 7 章 ， 这 两 章 详细 
阐述 了 这 一 话题 ， 但 是 如 果 没 有 很 好 地 掌握 基础 知识 ， 理 解 这 些 章节 将 会 很 难 。 
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1.8 ”小结 


口 软件 系统 可 以 可 视 化 为 图 ， 用 于 显示 ( 非 ) 期 望 的 系统 属性 。 

口 在 Java9 之 前 ,JAR 层级 上 的 关系 图 无 法 展示 。 这 导致 了 各 种 问题 ,主要 包括 JAR 地 狱 、 
手动 操作 的 安全 性 和 极 差 的 可 维护 性 。 

口 Java 平 台 模块 系统 的 存在 是 为 了 让 Java 理解 JAR 关系 图 ， 它 为 该 语言 带 来 了 工件 级 的 模 
块 化 。 最 重要 的 目标 是 实现 可 靠 配 置 和 强 封装 ， 以 及 提升 安全 性 、 可 维护 性 和 性 能 。 

口 这 些 是 通过 引入 模块 来 实现 的 ， 简 单 地 说 ,模块 就 是 JAR 加 上 描述 符 。 编 译 屁 和 运行 工 
具 解 析 描述 符 中 的 信息 ， 以 便 构 建 工件 依赖 关系 图 ， 实 现 本 章 中 所 承诺 的 优势 。 


















































模块 化 应 用 程序 剖析 








本 章 内 容 

口 展示 模块 化 应 用 程序 的 源 代码 
口 创建 模块 声明 

口 编译 模块 

口 运行 模块 化 应 用 程序 

















本 章 将 介绍 创建 模块 化 应 用 程序 的 整体 流程 ， 但 不 会 详细 解释 各 个 细节 。 第 3 章 、 第 4 章 和 
第 5 章 将 对 这 些 细节 进行 深入 探索 和 详细 阐述 。 在 面 对 模 块 系统 这 样 宏大 的 主题 时 ， 人 们 很 容易 
因 一 片 绿 戎 而 错失 整 片 森 林 , 这 就 是 本 章 先进 行 全 局 介绍 的 原因 。 通 过 呈现 一 个 简单 的 模块 化 应 
用 程序 ， 展 示 如 何 定义 和 编译 模块 ， 以 及 如 何 执行 这 个 应 用 程序 , 有 助 于 更 好 地 了 解 拼图 的 不 同 
部 分 是 如 何 组 合 在 一 起 的 。 

这 意味 着 我 会 先 带 你 跳 人 深水 区 ， 而 在 这 里 ， 眼 前 的 一 切 并 非 立 即 清晰 可 见 ， 但 是 不 必 过 度 
担心 未 知 的 事情 ,因为 很 快 一 切 都 会 得 到 详细 阐述 。 当 你 读 完 本 书 第 一 部 分 时 ,示例 中 的 所 有 内 
容 将 让 你 有 所 收获 。 因 此 ， 请 标记 这 些 页 ， 因 为 之 后 你 可 能 会 不 时 回 过 头 来 翻阅 它们 。 

2.1 节 将 描述 示例 应 用 程序 的 作用 、 包 含 的 各 种 类 型 以 及 它们 的 职责 。 模块 系 统 在 2.2 节 中 开 
始 发 挥 作用 ， 这 一 节 将 讨论 如 何 组 织 文 件 和 目录 、 描 述 模块 以 及 编译 和 运行 应 用 程序 。 这 些 简 要 
讨论 将 展示 模块 系统 的 许多 核心 机 制 , 并 通过 一 些 实例 说 明基 本 特性 不 足以 模块 化 复杂 应 用 程序 
的 问题 ， 而 后 者 正 是 2.3 节 的 主题 。 该 应 用 程序 的 下 载 地 址 见 本 书 文 前 部 分 “关于 本 书 "， 应 用 
程序 中 的 master 分 支 包 含 了 在 2.2 节 中 所 描述 的 内 容 。 










































































2.1 初 识 ServiceMonitor 








要 进行 模块 系统 实战 ， 就 需要 一 个 可 以 应 用 它 的 实例 项 目 。 这 个 项 目 具体 的 功能 并 不 重要 ， 
请 不 要 陷入 它 的 细节 。 

设想 一 个 通过 彼此 交互 满足 用 户 需 求 的 服务 网 络 一 一 可 能 是 社交 网 络 或 者 视频 平台 。 你 希望 
监视 这 些 服务 ， 以 确定 系统 的 健康 状况 ， 并 及 时 发 现 所 发 生 的 问题 〈 而 不 是 由 用 户 报告 )， 这 就 
是 该 示例 应 用 程序 的 由 来 。 
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该 示例 应 用 程序 名 为 ServiceMonitor， 它 与 各 个 独立 的 服务 交互 ， 收 集 并 聚合 诊断 数据 ， 最 
后 通过 REST 方 式 提供 数据 。 

注意 ”你 可 能 还 记得 1.2 节 或 图 1-10 中 的 应 用 程序 , 它 被 分 为 了 4 个 不 同 的 JAR。 我 们 

最 终 会 经 历 更 加 具体 的 模块 化 过 程 ， 但 这 是 2.2 节 要 探索 的 内 容 。 在 此 之 前 ， 先 考虑 一 

下 如 何在 单个 工件 中 实现 这 样 的 系统 一 一 单一 式 方法 ( monolithic approach )。 如 果 这 和 

第 1 章 不 是 百 分 百 一 致 ， 请 不 要 担心 ， 因 为 新 的 章节 会 有 新 的 细节 。 























幸好 ， 这 些 服务 已 经 收集 了 你 想 要 的 数据 ， 因 此 ServiceMonitor 要 做 的 就 是 定期 查询 它们 ， 
该 工作 由 Serviceobservez 的 实现 负责 。 在 获得 以 DiagnosticDataPoint 为 形式 的 诊断 数 
据 后 ，statistician 将 进行 处 理 并 汇总 至 statistics。 统 计 信 息 依次 存储 在 statistics- 
Repository 中 ， 并 通过 REST 协议 提供 。Monitor 类 会 将 这 些 内 容 全 部 联系 在 一 起 。 

图 2-1 展示 了 这 些 类 如 何 互 相关 联 。 为 了 更 好 地 了 解 其 工作 原理 ， 先 从 serviceobserver 
接口 的 代码 开始 学 习 ， 如 代码 清单 2-1 所 示 。 


























代码 清单 2-1 _ serviceobservezr 接口 


public interface ServiceObserver { 





DiagnosticDataPoint gatherDataFromService(); 


ES 


exposes 



















implements 
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图 2-1 构成 ServiceMonitor 应 用 程序 的 类 。serviceobserver 的 两 个 实现 分 别 使 用 

Alpha 和 Beta API 查询 服务 并 返回 诊断 数据 , 之 后 由 statistician 将 其 汇总 
至 statistics 中 。 统 计 信息 由 仓库 存储 和 加 载 ， 并 通过 REST API 对 外 提供 
访问 。Monitor 协调 所 有 工作 


上 述 内 容 看 似 简单 ， 但 遗憾 的 是 ， 并 非 所 有 数据 源 提供 的 都 是 相同 的 REST API， 所 以 存在 
两 种 API: Alpha 和 Beta。 这 就 是 ServiceObserver 接口 具有 两 个 实现 的 原因 ( 如 图 2-2 所 )。 
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第 
每 个 实现 各 自 访问 对 应 的 API， 并 确保 通过 相同 的 接口 将 数据 提供 给 应 用 程序 。 






ServiceObserver 





returns 





Diagnostic 


2 atherDataFromService 
DataPoint 8 0 







implements 


BetaService 
Observer 
图 2-2 被 查询 的 各 个 服务 在 提供 诊断 数据 时 有 两 种 不 同 的 API， 因 此 serviceObserver 


接口 有 两 种 不 同 的 实现 


Statistician 没有 自己 的 状态 一 一 它 只 提供 两 个 方法 ， 要么 创建 新 的 statistics 实例 ， 
要 么 将 现 有 统计 数据 和 新 数据 点 组 合成 更 新 后 的 统计 数据 ， 如 代码 清单 2-2 所 示 。 


implements 





AlphaService 
Observer 




















代码 清单 2-2 statistician 类 


public class Statistician { 


public Statistics emptyStatistics() { 
return Statistics.empty(); 


} 


public Statistics compute 
Statistics currentStats， 
Iterable<DiagnosticDataPoint> dataPoints) { 
Statistics finalStats = currentStats; 
for (DiagnosticDataPoint dataPoint : dataPoints) 
finalStats = finalStats.merge (dataPoint); 
return finalSstats; 


} 





} 


StatisticsRepository 并 没有 做 什么 花哨 的 事情 一 一 它 仅 仅 加 载 和 存储 统计 信息 ， 无 论 
它 通 过 序列 化 、JSON 文件 还 是 数据 库 来 实现 ， 本 示例 都 不 关心 ， 如 代码 清单 2-3 所 示 。 











代码 清单 2-3 statisticsRepository 类 


public class StatisticsRepository { 





public Optional<Statistics> load() { /* ... */ } 
BUuBliec void store(Statistics statisties)y { /* ss */ 3} 


} 
到 目前 为 止 , 已 经 可 以 收集 数据 点 , 将 其 转化 为 统计 数据 ， 并 进行 存储 了 。 你 所 缺少 的 是 能 
完成 所 有 工作 的 类 ， 它 应 该 可 以 定期 轮 询 数 据 源 并 将 最 终结 果 推 送 至 仓库 中 ， 这 就 是 Monitor 
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所 做 的 。 代 码 清单 2-4 展示 了 该 类 的 字段 和 upaateStatistics () 方 法 ， 后 者 实现 了 其 核心 功 
能 (省略 了 确保 任务 定期 运行 的 代码 )。 


代码 清单 2-4 Monitor 类 和 它 的 updatestatistics() 方 法 


public class Monitor { 


private final List<ServiceObserver> serviceObservers; 
private final Statistician statistician; 

private final StatisticsRepository repository; 
private Statistics currentStatistics; 

Hse 


private void updateStatistics() { 
List<DiagnosticDataPoint> newData = serviceObservers 
.Stream() 
.map (ServiceObserver: :gatherDataFromService) 
.Collect (toList()); 
Statistics newStatistics = statistician 
.Compute (currentStatistics, newData); 
currentSstatistics = newStatistics; 
repository.store (newStatistics); 


} 








ZA 

} 

Monitor 类 通过 currentstatistics 字段 (类 型 为 statistics ) 来 存储 最 近 一 次 的 统 
计 信 息 。 

当 有 请 求 需要 处 理 时 , 公开 REST API 的 MonitorServer 从 Monitor 对 象 获取 相应 (已 存 
储 在 内 存 或 持久 化 设备 中 ) 的 统计 信息 ， 然 后 响应 请 求 并 且 返 回 处 理 后 的 数据 ， 如 代码 清单 2-5 
所 示 。 


代码 清单 2-5 ” MonitorSserver 类 


public class MonitorServer { 





private final Supplier<Statistics> statistics; 

public MonitorServer (Supplier<Statistics> statistics) { 
this.statistics = statistics; 

} 

有 | 

private Statistics getStatistics() { 
return statistics.get(); 


} 


// [...] 
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需要 注意 一 个 有 趣 的 细节 : 虽然 Monitorserver 调用 了 Monitor, 但 并 不 依赖 它 。 这 是 
因为 MonitorServet 并 没有 引用 Monitor 对 象 ， 而 是 通过 supplier 接口 将 数据 转发 给 它 。 
原因 很 简单 :Monitor 协调 整个 应 用 程序 ， 这 使 它 成 为 一 个 较 爱 肿 的 类 。 人 们 自然 不 希望 仅 为 
了 调用 一 个 getter 方法 ， 而 将 REST API 耦 合 到 这 样 一 个 重量 级 的 对 象 上 。 在 Java 8 之 前 ,我 
可 能 已 经 创建 了 一 个 专用 接口 来 获取 统计 信息 ,并 让 Monitor 实现 它 ; 但 是 从 Java 8 开始 ,lambda 
表达 式 和 现 有 的 功能 接口 使 得 解 耦 变 得 容易 得 多 。 

总 而 言 之 ， 最 终 将 得 到 以 下 这 些 类 。 
周期 性 获取 服务 的 可 用 性 诊断 数据 。 
返回 DiagnosticDataPoint 对 象 的 服务 监控 接口 。 

D AlphaServiceObserver 和 BetaServiceObserver 分 别 监控 一 系列 服务 。 
口 statistician 一 一 对 基于 DiagnosticDatapPoint 的 统计 信息 进行 计算 。 
存放 计算 后 的 统计 信息 。 

存储 和 获取 统计 信息 。 

响应 REST 调用 ， 返 回 相应 的 统计 信息 。 

协调 所 有 工作 。 




















口 DiagnosticDataPoint 





口 ServiceObserver 























口 Statistics 








口 statisticsRepository 





口 MonitorServer 








口 Monitor 


2.2 ”模块 化 ServiceMonitor 


如 果 ServiceMonitor 是 真实 的 项 目 , 那么 在 实现 它 时 全 力 引 入 模块 系统 就 有 点 “ 杀 鸡 用 牛刀 ” 
了 。 然 而 ， 它 只 是 一 个 简单 示例 ， 用 来 剖析 模块 化 系统 ， 因 此 请 把 它 看 作 一 个 大 型 项 目 来 构建 。 

谈 到 构建 程序 结构 , 首先 要 将 应 用 程序 划分 成 模块 , 然后 再 讨论 文件 系统 上 的 源 代码 结构 布 
局 。 于 是 最 有 趣 的 步 又 来 了 : 如 何 声明 和 编译 模块 并 运行 应 用 程序 。 


















































2.3 将 ServiceMonitor 划分 为 模块 


将 应 用 程序 模块 化 的 最 常见 方式 是 分 离 关 注 点 (a separation of concerns )。ServiceMonitor 具 
有 以 下 内 容 (括号 中 为 相关 类 型 ): 
口 从 服务 端 收集 数据 ( serviceobserver 、DiagnosticDataPoint ); 
口 将 数据 整合 为 统计 信息 (statistician、Statistics ); 
口 持久 化 统计 信息 ( StatisticsRepository ); 
口 通过 RESTAPI 的 方式 对 外 提供 统计 信息 ( MonitorServer )。 
除了 这 些 逻 辑 层面 的 需求 ， 还 有 技术 上 的 内 容 : 
口 数据 收集 必须 隐藏 在 API 背后 ; 
口 Alpha 和 Beta 服务 需要 分 别 实 现 单独 的 API (AlphaServiceObserver 和 BetaService- 
Observer ); 


口 所 有 关注 点 都 必须 得 到 统一 的 协调 ( Monitor )。 
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要 点 ”这 就 要 求 下 列 模块 中 的 特定 类 型 必须 公开 可 见 : 








口 monitor.observer ( Serviceobserver、DiagnosticDatapPoint ) 
口 monitorobserveralpha (AlphaServiceObserver ) 

口 monitor.observer.beta (BetaServiceObserver ) 

口 monitor.statistics (Statistician、Statistics ) 

口 monitor.persistence (StatisticsRepository ) 

口 monitor.rest (MonitorServer ) * _ monitor (Monitor ) 




















将 这 些 模块 受 加 到 图 2-3 中 的 类 图 上 ， 可 以 很 容易 地 发 现 模块 的 依赖 性 。 


££— 


每 个 模块 包含 一 到 两 个 类 










类 间 的 依赖 关系 决定 了 
模块 间 的 依赖 关系 
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图 2-3 Sao Mio 应 用 程序 的 模块 ( 粗 体 ) 覆盖 了 类 结构 ( 常规 体 )。 请 留意 跨 模 块 
边界 的 类 依赖 是 如 何 决定 模块 的 依赖 性 的 





2.4 文件 的 目录 结构 布局 


图 2-4 展示 了 应 用 程序 的 目录 结构 。 每 个 模块 都 是 一 个 单独 的 项 目 ， 这 意味 着 每 个 模块 都 具 
有 单独 的 目录 结构 。 简 单 起 见 ， ee 如 果 你 参与 过 别 的 项 目 , 或 者 使 用 
过 Maven 、Gradle 或 其 他 构建 工具 ， 就 会 知道 这 一 般 是 默认 行为 。 
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第 三 


Te 
国 libs 已 编译 和 打包 模块 的 目录 





国 mods 一 一 
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方 依赖 





国 src 
国 main 





国 monitor 


目 module-info.java <—、、 


国 resources 








程序 的 其 中 一 个 模块 


包含 模块 的 源 代码 ， 从 
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模块 的 声明 (通常 在 
录 中 ) 











国 test 的 根源 代码 
罚 java< 一 模块 测试 源码 的 根 目录 ， 写 
如 menior 。 不 包含 模块 声明 ， 因 为 测试 
图 resources 。 通常 不 限于 本 模块 中 
国 target 
| 一] classesec 





图 
图 
国 
国 monitorpersistence 
国 monitorrest 

国 monitor statistics 


monitorobserveralpha 
monitorobserverbeta 








2-4 ServiceMonitor 应 月 

















下 的 模块 声明 文件 module-info.java 





目 pom.xml 模块 编译 的 目标 目录 
TS 


与 模块 相关 的 构建 工具 配置 


程序 的 每 个 模块 都 是 一 个 项 目 ， 
新 的 变化 包括 放置 了 所 构建 的 模块 化 JAR 的 mods 目录 ， 以 及 每 个 项 目 根 目录 











具有 众所周知 的 目录 结构 。 


首先 需要 注意 的 是 mods 目录 ， 稍 后 创建 的 模块 将 放置 在 此 ，4.1 节 将 详细 介绍 目录 结构 。 
libs 目录 稍 有 不 同 ， 其 中 包含 第 三 方 依 赖 。 在 实际 项 目 中 ， 因 为 有 构建 工具 管理 依赖 ， 所 以 
不 需要 libs。 但 是 对 于 手动 编译 和 启动 应 用 程序 而 言 ， 将 所 有 依赖 放 在 一 个 位 置 会 极 大 地 简化 操 




















作 ， 因 此 这 不 是 建议 或 要 求 ， 只 是 一 种 简化 手段 。 








不 同 寻 常 的 是 module-infojava 文件 ， 它 被 称 为 模块 声明 ， 负 责 定义 模块 的 属性 。 它 是 模块 
系统 和 本 书 的 核心 ，3.1 节 将 对 其 进行 详细 介绍 ， 不 过 下 一 节 会 先 粗略 介绍 一 下 。 


2.5 ”声明 和 模块 描述 











要 点 ”每 个 模块 都 有 一 个 模块 声明 文件 ， 按 照 惯例 ， 模 块 声明 文件 module-info. 
java 放置 在 项 目的 根 目录 下 。 编译 器 根据 此 文件 生成 模块 描述 符 module-info.class 


文件 。 编 译 代 码 打 包 成 JAR 时 ， 模块 描述 符 文件 必须 位 于 根 目 录 中 ， 以 方便 模块 


系统 进行 识别 和 处 理 。 


如 2.3 节 所 述 , 应 用 程序 由 7 个 模块 组 成 ,因此 必定 有 7 个 模块 声明 ， 如 代码 清单 2-6 所 示 。 
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即使 尚 不 了 解 细节 ， 也 能 大 概 猜 到 发 生 了 什么 。 
代码 清单 2-6 所 有 ServiceMonitor 模块 的 声明 


module monitor.observer { 
exports monitor.observer; 


} 





module monitor.observer.alpha { 
requires monitor.observer; 
exports monitor.observer.alpha; 


module monitor.observer.beta { 
requires monitor.observer; 
exports monitor.observer.beta; 


} 


module monitor.statistics { 
requires monitor.observer; 
exports monitor.statistics; 


} 


module monitor.persistence { 
requires monitor.statistics; 
requires hibernate.jpa; 
exports monitor.persistence; 
exports monitor.persistence.entity; 


} 


module monitor.rest { 
requires spark.core; 
requires monitor.statistics; 
exports monitor.rest; 


: 


module monitor { 
requires monitor.observer; 
requires monitor.observer.alpha; 
requires monitor.observer.beta; 
requires monitor.statistics; 
requires monitor.persistence; 
requires monitor.rest; 


} 


module the.name { } 语 句 块 定义 了 一 个 模块 。 名 称 (name ) 通常 采用 包 命 名 惯例 : 必须 
是 全 局 唯一 的 反 向 域名 ， 且 完全 小 写 ， 并 由 点 号 “.” 分 隔 各 段 ( 更 多 细节 参见 3.1.3 节 一 一 在 此 
用 更 短 的 名 称 只 是 为 了 让 它们 能 更 好 地 融入 本 书 的 段落 )。 在 module 语句 块 内 部 ，requires 
指令 表达 了 模块 间 的 依赖 ，exports 指令 则 指定 了 带 有 导出 类 型 的 包 的 名 称 ， 进 而 为 每 个 模块 
定义 了 公开 的 API。 





36 第 2 章 ”模块 化 应 用 程序 剖析 





2.5.1 声明 模块 依赖 








本 


到 


\ 要 点 ”requires 指令 包含 模块 名 ， 并 可 以 告知 JVM 当前 模块 的 依赖 模块 。 


显而易见 ，observer 的 实现 依赖 于 observer API。 由 于 statistician::compute 使 用 
API 接 口 的 DiagnosticDatapPoint 类 型 ， 因 此 statistics 模块 也 依赖 于 opserver。 

类 似 地 ，persistence 模块 由 于 需要 统计 信息 而 依赖 于 statistics 模块 ， 同 时 由 于 使 用 Hibemate 
来 访问 数据 库 而 依赖 于 Hibernate 模块 。 

接 下 来 ，monitorrest 因 人 处 理 统计 信息 而 依赖 于 statistics 模块 。 除 此 之 外 ， 它 还 采用 Spark 微 
服务 框架 提供 REST 服务 。2.1 节 在 介绍 应 用 程序 模块 化 时 ， 站 出 MonitorServer 不 依赖 于 
Monitor。 现在 这 一 点 派 上 用 场 了 ,这 意味 着 monitorrest 不 依赖 于 monitor。 这 很 棒 , 因为 monitor 
依赖 于 monitorrest， 而 模块 系统 禁止 声明 循环 依赖 。 最 后 ，monitor 依赖 于 所 有 其 他 模块 ， 因 为 
它 会 创建 大 多 数 实例 并 将 结果 在 模块 间 传 递 。 























2.5.2 ”定义 模块 的 公有 API 








通常 , 模块 导出 单个 包 一 一 定义 模块 对 外 功能 的 包 。 你 可 能 已 经 注意 到 了 , 包 名 始终 以 模块 
名 为 前 缀 一 一 它们 甚至 经 常 相同 。 这 不 是 强制 性 的 , 而 是 由 于 模块 和 包 名 都 遵循 反 向 域名 的 命名 
方案 。 

唯一 导出 多 个 包 的 是 persistence 模块 。 除 了 导出 核心 功能 ( statisticsRepository) 的 
monitor.persistence 包 外 ， 也 导出 monitor.persistence.entity 包 。 该 包 定 义 了 一 组 
被 注解 标示 的 类 ， 以便 Hibernate 了 解 如 何 进行 存储 和 加 载 (通常 称 为 实体 )。 这 意味 着 Hibernate 
必须 访问 这 些 类 ,因此 模块 必须 导出 对 应 的 包 。( 如 果 依 赖 Hibernate 反 射 到 私有 字段 或 构造 函数 ， 
那么 导出 是 不 必要 的 一 一 相关 解决 方案 参见 12.2 节 。 ) 

男 一 个 例外 是 monitor， 它 不 导出 任何 包 。 这 是 有 道理 的 ， 因 为 像 蜂 蛛 坐 在 蛛网 的 中 心 一 样 ， 
它 位 于 模块 图 的 中 心 ， 协 调 执行 流程 。 因 此 它 本 身 没 有 供 其 他 模块 调用 的 API， 主 模块 ( 通常 包 
含 main 函数 ) 一 般 不 导出 任何 包 。 
































2.5.3 ”用 模块 图 可 视 化 ServiceMonitor 


在 定义 完 模 块 的 依赖 和 导出 后 ， 再 来 看 看 生成 的 模块 图 ， 如 图 2-5 所 示 。 虽 然 它 看 起 来 只 是 
图 2-3 的 简化 版 ， 但 实际 上 远 不 止 如 此 ! 图 2-3 可 能 是 由 应 用 程序 的 架构 师 在 白板 上 绘制 的 ， 尽 管 
显示 了 模块 及 其 关系 , 但 它 只 是 想象 中 的 一 部 分 , 对 编译 器 或 虚拟 机 来 说 无 关 紧要 。 相 反 , 图 2-5 
是 模块 系统 对 体系 结构 的 解释 。 
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hibernate.jpa 


更 多 依赖 
图 2-5 ”此 应 用 程序 模块 图 展示 了 模块 和 导出 的 包 以 及 它们 之 间 的 依赖 关系 。 与 图 2-3 
不 同 ， 这 不 仅 是 一 个 体系 结构 图 ， 还 是 模块 系统 对 应 用 程序 的 看 法 























两 幅 图 中 的 模块 依赖 关系 看 起 来 如 此 相似 , 几乎 可 以 互 换 , 这 意味 着 代码 可 以 相当 准确 地 表 
达 对 应 用 程序 体系 结构 的 理解 ( 以 模块 声明 的 形式 )， 不 是 吗 ? 





写 代 码 的 方式 与 之 前 大 体 一 臻 

可 能 你 想 知 道 编写 代码 的 方式 是 否 会 与 Java9 之 前 的 版 本 有 所 不 同 。 在 绝 大 多 数 情 况 下 答 
案 是 否定 的 ， 不 过 有 些 细节 会 有 所 不 同 ， 第 6 章 和 第 7 章 将 为 你 详细 阐述 这 些 细节 。 

除了 对 项 目 进行 适当 的 模块 化 ,以 及 偶尔 需要 考虑 将 类 放 在 哪个 包 中 ,或 者 是 否 修改 依赖 
或 导出 ， 建 立领 域 模 型 和 解决 问题 的 日 常 工 作 将 保持 不 变 。 在 IDE 支持 下 ， 修 改 依赖 或 导出 
与 管理 包 导 入 一 样 简单 。 

组 织 大 型 代码 库 的 全 局 工作 将 变 得 更 加 容易 。 添 加 依赖 会 更 加 明确 , 这 有 利于 编程 、 代 码 
评审 或 体系 结构 评审 ， 确 保 感知 到 的 和 真实 的 架构 一 致 。 服 务 ( 参见 第 10 章 ) 和 聚合 器 模块 
(参见 11.1.5 节 ) 等 重要 功能 将 增强 模块 化 工具 一 如 果 使 用 得 当 ， 则 能 改善 设计 。 





2.6 ”编译 和 打包 模块 


在 将 项 目 整 齐 地 组 织 在 特定 模块 的 目录 中 , 创建 了 模块 声明 并 编写 了 代码 后 , 就 可 以 构建 并 
( 稍 后 ) 运行 应 用 程序 了 。 要 构建 应 用 程序 ， 你 需要 创建 模块 工件 ， 这 个 过 程 分 为 两 步 : 编译 和 
打包 。 
在 编译 时 ， 编 译 器 需要 知道 声明 引用 的 模块 位 置 ， 对 Java 自身 的 模块 而 言 这 轻而易举 ， 因 
为 编译 器 知道 依赖 位 于 何人 处 (在 运行 时 环境 的 libs/modules 文件 中 )。 
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要 点 “为 了 能 找到 自己 的 模块 ， 人 们 必须 使 用 模块 路 径 ， 即 一 个 与 类 路 径 平行 的 
概念 。 顾名思义 ， 它 期 望 存放 模块 化 JAR 而 不 是 普通 JAR。 当 编译 器 搜索 引用 的 
模块 时 ,会 对 它 进行 扫描 。 为 了 定义 模块 路 径 ，javac 增加 了 一 个 新 选项 : 
--module-path, 或 简称 -p ( 思路 与 JVM 启动 应 用 程序 时 相同 。 相 应 地 ，java 
引入 了 相同 的 选项 --module-path 和 -p， 它 们 有 具有 相同 的 功能 )。 


选择 mods 目录 存放 模块 意味 着 以 下 两 点 : 
口 模块 路 径 包 含 mods 目录 ; 
口 mods 目录 包含 已 打包 的 工件 。 

某 些 模块 具有 外 部 依赖 : persistence 模块 需要 Hibernate ( hibernate.jpa), 而 REST 模 块 
需要 Spark ( spark.core )。 假 设 它 们 的 工件 已 经 是 模块 化 的 JAR， 与 其 依赖 项 一 起 被 放 在 了 
mods 目录 中 。 

如 果 将 普通 JAR 放 在 模块 路 径 上 ， 或 者 将 模块 化 JAR 放 在 类 路 径 上 ， 甚 至 混合 搭配 会 发 生 
什么 情况 ?如 果 依 赖 尚未 模块 化 但 你 想 使 用 它 ， 该 怎么 办 ?这 些 属于 向 模块 化 迁移 的 内 容 , 第 9 
章 将 详细 说 明 。 

基于 这 些 先 决 条 件 ， 可 以 编译 和 打包 模块 。 从 monitor.observer 开始 ， 它 没有 依赖 项 ， 不 包 
含 任何 新 内 容 一 一 使 用 旧版 本 的 Java 来 运行 也 会 获得 相同 的 结果 。 


列 出 或 找到 所 有 源 文件 。 在 本 例 中 是 : 
编译 的 目标 目录 monitor.observer/src/main/java/monitor/ 












































observer/DiagnosticDataPoint.java 和 
monitor.observer/src/main/java/monitor/ 
observer/ServiceObserver.java 


$ javac 
-d monitor.observer/target/classes 
$s{source-files} 
$ jar --create 
| > --file mods/monitor.observer.jar 





-C monitor.observer/target/classes 


为 mods 中 的 新 JAR 文件 命 已 编译 的 源 文件 


monitor.alpha 模块 有 依赖 项 ， 因 此 必须 使 用 模块 路 径 来 告诉 编译 器 在 哪里 可 以 找到 所 需 的 工 
件 。 当 然 , 用 jar 命令 打包 不 受 其 影响 。 


$ javac --module-path mods 十 
-d monitor.observer.alpha/target/classes 
Ss{source-files} 
S jar --create 
--file mods/monitor.observer.alpha.jar 
-C monitor.observer.alpha/target/classes . 


javac 将 在 目录 中 搜索 代 
码 所 依赖 的 模块 








大 多 数 其 他 模块 大 致 相同 。 一 个 例外 是 monitor.rest， 它 有 位 于 libs 目录 中 的 第 三 方 依赖 项 ， 
因此 需要 将 libs 添加 到 模块 路 径 中 。 


S javac --module-path mods:libs 十 模块 在 两 个 目录 中 有 依赖 , 因此 这 
-d monitor.rest/target/classes 


st 两 个 目录 都 被 添加 到 模块 路 径 中 
source-files} 


2.8 扩展 模块 化 代码 库 39 





另 一 个 例外 是 monitor， 需 要 告知 模块 系统 它 有 一 个 作为 应 用 程序 人 口 点 的 main 函数。 


$ javac --module-path mods 
-d monitor/target/classes 
$s{source-files} 
$ jar --create ee 
--file mods/monitor.jar 该 类 包含 应 用 程序 的 
--main-class monitor.Monitor | main 函数 
-C monitor/target/classes . 


图 2-6 显示 了 最 终 内 容 。 这 些 JAR 文件 就 像 普通 的 旧 JAR, 但 有 一 点 例外 : 每 个 文件 都 包含 
一 个 模块 描述 符 module-info.class 文件 ， 将 其 标记 为 模块 化 JAR。 
ServiceMonitor 


加 mods 
monitorjar 











monitor.observer.jar 
monitor.observer.alpha.jar 





monitor.observer.beta.jar 
monitor.persistence.jar 
monitor.rest.jar 








IIUUUUUIY 


monitor statistics .jar 


> 国 .… 
2-6 ”所 有 应 用 程序 模块 被 编译 和 打包 到 mods 





录 并 且 已 经 准备 好 启动 了 





2.7 ”运行 ServiceMonitor 











在 所 有 模块 被 编译 到 mods 目录 后 ,终于 可 以 启动 应 用 程序 了 。 如 接 下 来 的 简要 说 明 所 示 ， 
这 就 是 模块 声明 工作 的 价值 所 在 。 


$ java 
--module-path mods:libs 


-=modul i 
module monitor < 要 启动 模块 的 名 称 














_。 |java 搜索 模块 的 目录 


要 点 ”你 需要 做 的 只 是 调用 java, 指定 模块 路 径 , 让 java 知道 从 哪里 可 以 找到 
应 用 程序 所 包含 的 工件 ， 并 且 告 诉 它 启动 哪个 模块 。 而 解析 所 有 依赖 、 避 免 调 用 
冲突 或 含混 不 清 的 版 本 ， 以 及 用 正确 的 模块 启动 等 工作 都 是 由 模块 系统 处 理 的 。 





2.8 扩展 模块 化 代码 库 


当然 ， 任 何 软 件 项 目 都 不 会 真正 结束 〈 除非 项 目 “ 死 掉 ”)， 所 以 变化 是 不 可 避免 的 。 举 个 例 
子 ， 如 果 你 想 增 加 另 一 个 observer 实现 ,那么 会 发 生 什么 呢 ? 通常 你 会 采取 以 下 这 些 步 又 。 

(1) 为 其 开发 子 项 目 。 

(2) 进行 构建 。 
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(3) 在 现 有 代码 中 使 用 它 。 
这 就 是 你 现在 需要 做 的 。 对 于 新 模块 而 言 ， 添 加 模块 声明 就 能 使 其 融入 模块 系统 。 


module monitor.observer.gamma { 
requires monitor.observer; 





exports monitor.observer.gamma; 


} 


像 其 他 模块 一 样 ， 对 它 进行 编译 和 打包 。 


$ javac --module-path mods 
-d monitor.observer.gamma/target/classes 
$s{source-files} 
S jar --create 
--file mods/monitor.observer.gamma.jar 
-C monitor.observer.gamma/target/classes . 


然后 将 它 作为 依赖 添加 到 现 有 代码 中 。 


module monitor { 
requires monitor.observer; 




















requires monitor.observer.alpha; 
requires monitor.observer.beta; 
requires monitor.observer.gamma; 
requires monitor.statistics; 
requires monitor.persistence; 
requires monitor.rest; 


} 

这 样 就 完成 了 。 如 果 构 建 包含 了 编译 和 打包 ,你 需要 做 的 就 只 是 添加 或 修改 模块 声明 。 删 除 
或 重 构 模块 也 是 如 此 : 除了 通常 需要 做 的 改动 外 ,还 需要 稍微 思考 一 下 ,这 将 如 何 影 响 你 的 模块 
图 并 更 新 相应 的 模块 声明 。 


2.9 总 结 : 模块 系统 的 效果 

到 目前 为 止 一 切 都 很 顺利 , 不 是 吗 ?在 后 面 几 章 对 模块 系统 的 细节 进行 深入 探索 之 前 , 先 花 
一 些 时 间 来 了 解 模块 系统 承诺 的 两 个 好 处 ， 以 及 利用 某 些 高 级 特性 可 以 解决 哪些 边 角 残 留 问 题 。 
2.9.1 模块 系统 能 为 你 做 什么 


1.5 节 在 讨论 模块 系统 的 目标 时 ， 谈 论 了 其 中 最 重要 的 两 个 目标 : 可 靠 配置 和 强 封装 。 在 构 
建 了 一 些 较为 具体 的 东西 之 后 , 现在 回顾 一 下 这 些 目标 , 并 且 观 察 一 下 它们 如 何 帮 人 们 交付 健壮 
并 且 可 维护 的 软件 。 


1. 可 靠 配置 
如 果 一 个 依赖 无 法 在 mods 中 找到 会 怎么 样 ? 如 果 两 个 依赖 需要 同一 个 项 目 (例如 Log4j 或 
Guava ) 的 不 同 版 本 会 怎么 样 ? 如 果 两 个 模块 有 意 或 无 意 地 导出 了 两 个 相同 的 类 型 会 怎么 样 ? 




























































































在 类 路 径 机制 下 ,这些 问题 会 在 运行 时 暴露 ， 其 中 一 些 会 使 应 用 程序 骨 溃 ， 另 外 一 些 则 较为 
隐蔽 ,不 易 被 察觉 ,最终 导致 错误 的 程序 行为 。 在 模块 系统 中 ,许多 像 这 样 不 可 靠 的 情况 ( 尤其 
是 刚刚 提 到 的 这 些 ) 会 更 早 被 发 现 。 编 译 器 或 JVM 会 终止 运行 并 返回 一 条 具体 的 提示 信息 ， 给 
人 们 一 个 修复 错误 的 机 会 。 

例如 ， 当 应 用 程序 启动 但 无 法 找到 monitor statistics 时 ， 你 将 得 到 如 下 提示 。 

> Error occurred during initialization of boot layer 

> java.lang.module.FindException: 


> Module monitor.statistics not founa， 
> required by monitor 














类 似 地 , 当 模 块 路 径 中 存在 两 个 SLF4J 版 本 时 , 启动 ServiceMonitor 应 用 程序 将 得 到 如 下 结果 。 


> Error occurred during initialization of boot layer 

> java.lang.module.FindException: 

> Two versions of module org.slf4j.api found in mods 

> (org.slf4j.api-1.7.25.jar and org.slf4j.api-1.7.7.jar) 

















你 再 也 不 会 意外 地 依赖 于 某 个 间接 依赖 了 。Hibernate 会 使 用 SLF4J, 这 意味 着 应 用 程序 启动 
时 这 个 库 一 直 存 在 。 但 是 一 旦 开始 导入 SLF4J (没有 出 现在 任何 模块 声明 中 ) 中 的 类 型 ,编译 器 
就 会 进行 阻止 ， 并 提示 你 正在 使 用 一 个 没有 明确 依赖 的 模块 中 的 代码 。 

> monitor.persistence/src/main/java/.../StatisticsRepository.java:4: 

error: package org.slf4j is not visible 


> (package org.slf4j is declared in module org.slf4j.api, 
> but module monitor.persistence does not read it) 


即使 你 想 办 法 绕 过 了 编译 器 的 检查 ， 模 块 系统 也 会 在 启动 时 执行 相同 的 检查 。 


2. 强 封装 

现在 让 我 们 从 模块 使 用 者 的 角度 切换 到 模块 维护 者 的 角度 。 想象 一 下 , 为 了 修复 一 个 bug 或 者 
改善 性 能 ， 对 monitor.observer.alpha 进行 重 构 。 在 发 布 一 个 新 版 本 之 后 ,你 发 现 monitor 中 的 一 些 代 
码 无 法 正常 工作 ， 这 造成 了 应 用 程序 不 稳定 。 如 果 你 改动 了 一 个 公有 API， 那 么 这 是 你 的 错误 。 

但 是 ， 如果 你 改动 了 某 一 类 型 的 内 部 实现 细节 ,而 这 个 类 型 虽然 被 标记 为 不 支持 , 但 仍然 被 
调用 了 呢 ? 有 可 能 这 个 类 型 应 该 是 公有 的 , 因为 你 想 在 两 个 包 中 使 用 这 个 类 型 ; 也 有 可 能 monitor 
的 开发 者 通过 反射 访问 了 它 。 在 这 种 情况 下 ， 你 无 法 阻止 用 户 依赖 于 实现 。 

在 模块 系统 的 帮助 下 ,这 种 情况 得 以 避免 。 事实 上 你 已 经 做 到 了 : 只 有 被 导出 的 包 中 的 类 型 
才 是 可 见 的 ， 其 余 的 都 很 安全 ， 即 使 通过 反射 也 无 法 访问 。 
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注意 ”如果 万 不 得 已 确实 需要 深入 访问 某 个 模块 内 部 ， 请 参阅 7.1 节 和 12.2.2 节 。 


2.9.2 ”模块 系统 还 能 为 你 做 些 什么 


虽然 ServiceMonitor 的 模块 化 进行 得 很 顺利 ,但 是 仍 有 一 些 不 足 之 处 值得 讨论 。 目 前 你 对 此 还 
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无 计 可 施 ， 但 是 本 书 第 三 部 分 介绍 的 高 级 特性 可 以 帮 你 解决 这 些 问 题 。 本 节 将 预览 这 些 高 级 特性 。 


1. 标记 不 可 或 缺 的 模块 依赖 

monitor.observer.alpha 模块 和 monitor.observer.beta 模块 声明 了 对 monitor.observer 的 依赖 。 这 
是 合理 的 , 因为 它们 实现 了 后 者 暴露 的 ServiceObserver 接口 , 同时 返回 了 属于 同一 个 模块 的 
DiagnosticDataPoint 实例 。 


这 在 任何 使 用 实现 模块 的 代码 上 都 会 导致 有 趣 的 结 


ServiceObserver observer 
DiagnosticDataPoint data 




















new AlphaServiceObserver ("some://service/url"); 
observer.gatherDataFromService(); 


包含 这 两 行 代码 的 模块 同时 也 需要 依赖 monitorobserver ,否则 它 将 无 法 访问 ServiceObserver 
类 型 和 DiagnosticDataPoint 类 型 。 如 果 调 用 代码 没有 依赖 monitor observer， 整 个 monitor. 
observer.alpha 模块 就 会 变 得 毫 无 意义 。 

只 有 当 调 用 代码 明确 依赖 于 另外 一 个 模块 时 才 可 用 ,这样 的 模块 实在 太 思 奏 了 。 幸 好 有 办 法 ! 
11.1 节 将 介绍 隐 式 可 读 性 (implied readability )。 














2. 解 而 API 的 实现 和 调用 
思考 一 下 monitor.observer 与 它 的 实现 模块 monitor.observer.alpha 和 monitorobserver.beta 之 间 
的 关系 ， 就 会 发 现 一 些 别 的 问题 。 为 什么 monitor 必须 知道 具体 实现 ? 
就 目前 而 言 ，monitor 需要 实例 化 具体 的 类 ， 但 之 后 仅 与 相关 的 接口 进行 交互 。 为 了 调用 一 
个 构造 函数 而 依赖 整个 模块 似乎 有 些 匈 余 。 实 际 上 ， 在 任何 时 候 ， 要 移 除 一 个 废弃 的 
ServiceObserver 实现 或 引入 一 个 新 的 实现 ， 你 都 不 得 不 更 新 monitor 的 模块 依赖 并 且 重 新 编 
译 、 打 包 和 部 署 工 件 。 

为 了 让 API 的 实现 和 调用 方 之 间 实 现 更 松散 的 耦合 ， 像 monitor 这 样 的 调用 方 不 需要 依赖 诸 
如 monitor.observer.alpha 和 monitor.observer.beta 这 样 的 实现 , 模块 系统 能 够 实现 这 个 目标 。 第 10 
章 将 讨论 这 个 问题 。 


3. 让 导出 更 明确 
还 记得 那个 包含 被 注释 为 仅 被 Hibernate 使 用 的 数据 传输 对 象 的 包 吗 ”持久 化 模块 是 如 何 将 
它 导出 的 ? 
module monitor.persistence { 
requires monitor.statistics; 


requires hibernate.jpa; 
exports monitor.persistence; 









































exports monitor.persistence.entity; 


} 


这 看 起 来 不 太 对 一 一 只 有 Hibernate 需要 访问 这 些 实体 ,但 现在 , 其 他 依赖 monitorpersistence 
的 模块 ， 比 如 monitor， 也 可 以 看 到 它们 。 








你 又 接触 到 了 一 个 模块 系统 的 高 级 特性 。 合 规 导 出 能 让 某 个 模块 将 一 个 包 导 出 给 一 些 指定 的 
模块 ， 而 非 所 有 模块 。11.3 节 将 介绍 这 个 机 制 。 


4. 使 包 仅 用 于 反射 

即便 将 包 仅 导 出 给 指定 的 模块 ， 有 时 也 过 于 复杂 。 

口 你 会 基于 API [ 例如 Java 持久 层 API (JPA )] 编译 模块 而 不 是 基于 具体 实现 (例如 

Hibernate )， 因 此 需要 在 合 规 导出 中 小 心 豆 豆 地 提 及 实现 模块 。 

口 你 可 以 使 用 基于 反射 的 工具 ( 例如 Hibernate 或 Guice ) 仅 在 运行 时 通过 反射 访问 代码 ， 

那么 为 什么 要 在 编译 时 让 其 可 被 访问 呢 ? 

D 你 会 依赖 于 对 私有 成 员 的 反射 (Hibernate 在 配置 字段 注入 后 会 这 么 做 )， 而 这 在 导出 包 中 
无 法 实现 。 

12.2 节 星 现 了 一 个 解决 方案 一 一 引入 开放 式 模块 和 开放 式 包 。 这 让 一 些 包 仅 在 运行 时 可 用 。 
作为 交换 ， 它 允许 针对 私有 成 员 的 反射 ,因为 基于 反射 的 工具 通常 会 这 么 要 求 。 此 外 还 有 合格 开 
放 ， 它 与 导出 类 似 ， 你 可 以 通过 它 将 某 个 包 仅 开放 给 一 些 指 定 的 模块 。 

如 果 曾 用 过 Hibernate 作为 JPA 提供 者 , 那么 你 也 许 曾 花 了 很 大 心思 来 阻止 对 Hibernate 的 直 
接 依 赖 。 这 种 情况 下 将 某 个 依赖 硬 编码 到 模块 声明 中 绝 不 会 是 你 想 看 到 的 。12.3.5 节 将 详细 讨论 


这 个 场景 。 
2.9.3 ”人 允许 可 选 依赖 


仅 当 运行 中 的 应 用 程序 存在 某 个 依赖 时 ， 某 些 代码 才 会 执行 ， 而 这 种 情况 并 不 罕见 。 比 如 
monitor.statistics 模块 中 可 能 有 一 些 代 码 使 用 了 一 个 时 竖 的 静态 类 库 ， 而 也 许 是 因为 许可 证 的 问 
题 ， 当 ServiceMonitor 启动 时 ， 这 个 库 并 非 总 是 存在 。 另 一 个 例子 是 具有 某 些 特性 的 类 库 ， 而 这 
些 特性 仅 在 某 个 第 三 方 依赖 存在 时 才 会 激发 用 户 的 兴趣 一 一 比如 一 个 测试 框架 当 某 个 断言 
库存 在 时 这 个 测试 框架 才 会 与 它 协同 工作 。 

而 根据 我 们 早先 讨论 的 , 模块 声明 中 必须 声明 依赖 。 这 强制 规定 依赖 在 编译 时 必须 存在 ， 以 
方便 编译 成 功 。 但 很 不 幸 ，recuires 关键 字 意 味 着 依赖 在 启动 时 也 必须 存在 ， 和 否则 JVM 会 拒 
绝 运 行 应 用 程序 。 

这 很 难 令 人 满意 。 但 正如 预期 的 那样 ， 模 块 系统 为 其 保留 了 一 条 出 路 ， 即 可 选 依赖 。 它 在 编 
译 时 必须 存在 ， 在 运行 时 却 不 是 必需 的 。11.2 节 将 对 此 进行 讨论 。 在 讨论 了 所 有 高 级 特性 之 后 ， 
15.1 节 将 展示 ServiceMonitor 的 另外 一 个 实现 ， 其 中 使 用 了 大 部 分 高 级 特性 。 

关于 定义 、 构 建 和 运行 一 个 模块 化 应 用 程序 , 第 3 章 、 第 4 章 和 第 5 章 分 别 对 这 3 个 步骤 进 
行 了 讲述 。 它 们 都 很 重要 , 但 是 第 3 章 尤 为 重要 ， 因 为 它 讲 解 了 模块 系统 底层 的 基本 概念 和 基本 
原理 。 
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2.10 ”小 结 








口 在 将 一 个 应 用 程序 模块 化 时 ， 可 以 根据 跨越 模块 边界 的 类 型 依赖 来 推断 出 模块 依赖 ， 这 

让 创建 初始 的 模块 依赖 关系 图 变 得 非常 直观 。 

口 多 模块 项 目的 目录 结构 与 Java 9 之 前 的 目录 结构 相似 ， 所 以 现 有 的 工具 和 手段 均 可 以 继 

续 工作 。 

口 模块 声明 一 一 项 目 根 目录 中 的 module-info.java 文件 是 模块 系统 在 代码 级 别 带 来 的 最 明显 
的 变化 。 它 为 模块 命名 并 声明 了 依赖 和 公有 API。 除 此 之 外 ,编写 代码 的 方式 基本 上 没有 
任何 变化 。 

口 javac、jar 和 java 命令 已 经 更 新 以 支持 模块 。 最 明显 的 相关 变化 是 模块 路 径 ( 命令 行 

参数 --module-path 或 -p )。 它 与 类 路 径 具 有 相同 的 地 位 ， 但 为 模块 服务 。 












































第 3 章 
定义 模块 及 其 属性 








本 章 内 容 

口 什么 是 模块 以 及 模块 声明 如 何 定义 它们 
口 辨识 不 同类 型 的 模块 

口 模块 可 读 性 和 可 访问 性 

口 理解 模块 路 径 

口 用 模块 解析 构建 模块 图 























关于 模块 ， 本 书 已 经 谈论 了 很 多 。 模块 不 仅 是 模块 化 应 用 程序 的 基石 ， 也 是 理解 模块 系统 的 
基石 。 因 此 ， 必 须 更 深入 地 了 解 模块 是 什么 ， 以 及 它们 的 属性 如 何 塑造 程序 的 行为 。 

本 章 探索 了 定义 、 构 建 和 运行 模块 这 3 个 基本 步骤 中 的 第 一 个 ( 另外 两 个 步骤 参见 第 4 章 和 
第 5 章 )， 详 细 解 释 了 什么 是 模块 ， 以 及 模块 声明 如 何 定义 其 名 称 、 依 赖 和 API (参见 3.1 前 。 
JDK 中 的 一 些 示例 会 引 你 初 宕 模块 世界 .本章 即 将 在 Java 9 中 探索 模块 ,并 对 各 种 模块 进行 分 类 ， 
为 你 在 模块 世界 中 导航 。 

本 章 也 会 讨论 模块 系统 如 何 (借助 扩展 、 编 译 器 和 运行 时 ) 与 模块 进行 交互 (参见 3.2 节 和 
3.3 节 )。 最 后 ,本 章 会 介绍 模块 路 径 ， 以 及 模块 系统 如 何 解析 依赖 并 基于 它们 构建 模块 图 ( 参见 
3.4 敬 。 

如 果 想 进行 实践 ， 可 以 查看 ServiceMonitor 的 master 分 文 ， 它 包含 了 大 多 数 本 章 展 示 的 模块 
声明 。 在 本 章 结尾 ， 你 将 了 解 如 何 定义 模块 的 名 称 、 依 赖 和 API， 以 及 模块 系统 如 何 基于 该 信息 
开展 工作 。 你 将 能 够 理解 、 分 析 模 块 系统 抛 出 的 错误 信息 并 将 其 修复 。 


























提示 

本 章 为 后 文 内 容 黄 定 了 基础 ， 本 书 的 其 余部 分 都 与 之 相关 。 为 了 让 这 些 关联 更 明晰 ， 本 章 
包含 很 多 前 向 引用 。 如 果 这 些 前 向 引用 影响 了 阅读 ,请 忽略 它们 ; 但 是 ， 当 翻阅 本 章 ， 寻 找 某 
些 特定 内 容 时 ， 它 们 会 变 得 非常 重要 。 
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在 对 模块 进行 了 这 么 多 讨论 后 ,是 时 候 进 行 实践 了 。 在 学 习 如 何 声明 模块 
一 下 两 种 文件 格式 一 一 JMOD 和 模块 化 JAR。 你 将 在 其 中 接触 并 进一步 了 解 模块 。 
其 余部 分 的 讨论 ， 本 章 在 此 对 不 同类 型 的 模块 进行 了 分 类 。 








3.1.1 随 JDK 发 布 的 Java 模 块 JMOD) 


发 性 之 前 ， 首 先 看 


为 了 方便 本 书 


在 Jigsaw 项 目 中 ，Java 代码 库 被 拆 分 成 了 大 约 100 个 模块 ， 这 些 模块 以 一 种 称 为 JMOD 的 








新 格式 交付 。 它 被 刻意 指明 基本 
只 供 JDK 使 用 ， 在 此 不 会 进行 深入 讨论 。 


我 们 虽然 无 法 创建 JMOD ， 但 仍然 可 以 剖析 它 。 调 用 java --1list-module 

















F JAR 格式 〈 本 质 上 是 个 ZIP 文件 ) 以 避免 使 用 全 新 的 格式 。 它 


s， 以 查阅 JRE 


或 JDK 所 包含 的 模块 ,这 些 信息 存储 在 一 个 优化 过 的 模块 列表 文件 中 一 一 运行 时 安装 的 libs 目录 
中 的 modules 文件 。JDK ( 而 非 JRE ) 的 jmods 目录 中 也 包含 裸 模块 。 男 外 ， 你 可 以 在 与 jmods 
目录 相 邻 的 bin 目录 中 找到 一 个 新 的 工具 一 一 jmod， 它 的 describe 操作 可 以 用 来 输出 JMOD 





的 属性 。 


以 下 代码 片段 展示 了 一 个 剖析 JMOD 文件 的 例子 。 此 处 ，jmoa 用 来 描述 一 个 Linux 系统 中 


的 java.sql 模块 。JDK 9 安装 在 /opt/jdk-9 中 。 像 大 多 数 Java 模块 一 样 ，java.sql 使 月 





系统 的 高 级 特性 ， 因 此 并 非 所 有 的 细节 都 会 在 本 章 详 述 。 


S jmod describe /opt/jdk-9/jmods/java.sql.jmod 


a 


base mandated 
logging transitive 
Xml transitive 





java.sql@9.0.4 

exports java.sqal 
exports javax.sql 
transaction. 


be 





> 
pr 
< java.sql 模块 囊括 且 向 其 他 模块 公 
> exports javax. 开 的 包 〈3.1.3 节 将 介绍 导出 ) 


requires java. 


requires java. 十 


V 


隐 式 可 读 性 的 依赖 
(参见 11.1 节 ) 





V 


requires java. 


日 了 知 干 个 模块 


模块 版 本 以 简单 字符 串 的 形式 
记录 于 该 文件 中 ， 此 处 是 9.0.4 


uses java.sql.Driver 


uses 指令 与 服务 相连 (参见 第 10 章 ， 





> platform linux-amgd64 


源 于 java.base 的 一 种 特殊 情况 (参见 3.1.4 节 ) 


3.1.2 ”模块 化 JAR: 内 生 模 块 





-十 
requires 指令 声明 依赖 。 术 语 “mandated” 





尤其 是 10.2.1 节 ) 


该 模块 为 特定 的 操作 系统 和 
硬件 架构 而 构建 





如 果 不 能 创建 JMOD, 那么 要 如 何 交 付 自己 创建 的 模块 呢 ? 这 就 是 模块 化 JAR 的 作用 所 在 。 
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定义 : 模块 化 JAR 和 模块 描述 符 

模块 化 JAR 基本 上 只 是 普通 的 JAR， 只 有 一 处 小 细节 有 所 不 同 。 它 的 根 目录 包含 一 个 模 
块 描述 符 : module-info.class 文件 。( 本 书 将 不 带 模块 描述 符 的 JAR 称 为 普通 JAR， 但 这 并 非 
官方 术语 。) 














模块 系统 创建 模块 运行 时 镜像 所 需要 的 全 部 信息 都 包含 在 模块 描述 符 中 ,一 个 模块 的 所 有 属 
性 都 会 在 这 个 文件 中 呈现 ; 同样 ,本 书 讨 论 的 很 多 特性 在 这 个 文件 中 也 有 相对 应 的 表述 。 基 于 源 
文件 创建 这 样 的 描述 符 ( 将 在 下 一 节 讲 述 ) 并 将 其 包含 进 JAR, 开发 者 可 以 手动 创建 模块 ， 某 个 
工具 可 以 自动 创建 模块 。 

虽然 包含 模块 描述 符 的 普通 JAR 变 成 了 模块 化 JAR, 但 它 不 必 强 制 按照 模块 化 JAR 来 使 用 。 
调用 方 可 以 将 其 放 入 类 路 径 ， 把 它 作 为 一 个 普通 JAR 来 使 用 ， 并 忽略 所 有 与 模块 相关 的 属性 。 
这 对 于 逐步 模块 化 现 有 项 目 是 不 可 或 缺 的 。( 8.2 节 将 介绍 无 名 模块 。) 


3.1.3 ”模块 声明 : 定义 模块 的 属性 


由 此 可 见 ， 将 任何 旧 的 JAR 转变 成 一 个 模块 ， 唯 一 需要 做 的 只 是 为 其 添加 模块 描述 符 
module-info.class。 这 带 来 了 一 个 问题 一 一 如 何 创建 一 个 模块 描述 符 。 就 像 它 的 文件 扩展 
名 .class 所 暗示 的 ， 它 是 通过 编译 源 文 件 获 得 的 。 













































































定义 : 模块 声明 
模块 描述 符 由 模块 声明 编译 而 来 。 按 照 约 定 ， 模 块 声明 是 项 目 源 码 根 目录 中 的 
module-info.java 文件 。 模 块 声明 是 模块 和 模块 系统 的 核心 元 素 。 


声明 与 描述 

你 可 能 担心 会 将 术语 模块 声明 和 模块 描述 符 弄 混 。 若 果真 如 此 ， 这 通常 也 不 是 什么 大 问 
题 。 前 者 是 源 代 码 ， 后 者 是 字 节 码 ， 它 们 只 是 同一 个 概念 的 不 同形 式 而 已 ， 都 表示 某 个 定义 
模块 属性 的 东西 。 在 特定 上 下 文中 通常 只 有 一 个 合适 的 选项 ， 所 以 使 用 哪 种 形式 一 般 情 况 下 
都 是 清晰 的 。 

如 果 这 个 解释 还 不 能 令 你 满意 ， 并 且 你 希望 能 确保 万 全 ， 那 么 我 来 分 享 一 下 自己 的 理解 : 
在 词典 中 ， 声 明 在 描述 符 之 前 出 现 一 -这 很 巧妙 ， 因 为 从 时 间 上 讲 ， 你 先 得 到 源 代码 ， 然 后 才 
是 字 节 码 。 两 个 顺序 是 一 致 的 : 先 得 到 声明 / 源 代码 ， 然 后 是 描述 符 / 字 节 码 。 














模块 声明 决定 了 一 个 模块 在 模块 系统 中 的 标识 和 行为 。 后 面 章节 介绍 的 许多 特性 在 模块 声明 
中 有 相对 应 的 部 分 ， 并 会 在 合适 的 时 机 呈现 。 现 在 看 一 下 JAR 缺乏 的 3 个 基本 属性 : 名 称 、 明 
确 的 依赖 以 及 内 部 封装 。 
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要 点 ”这 是 一 个 简单 的 module-infojava 文件 的 结构 ， 它 定义 了 这 3 个 基本 属性 。 





module S${module-name} { 
requires ${module-name}; 
exports S${package-name}; 


} 


当然 ，$ {module-name} 和 $ {package-name} 需 要 被 实际 的 模块 名 和 包 名 替代 。 
以 ServiceMonitor 的 monitor.statistics 模块 为 例 。 
module monitor.statistics { 

requires monitor.observer; 


exports monitor.statistics; 


} 


很 容易 辨识 出 前 文 描述 的 结构 :module 关键 字 后 面 跟 着 模块 名 , 主体 部 分 包含 了 requires 
和 exports 指令 。 下 一 节 将 讲述 如 何 声明 这 3 个 属性 。 








module、requires、exports 以 及 后 续 介 绍 的 一 些 新 的 关键 字 ， 在 一 些 已 有 代码 中 可 
能 已 经 被 用 作 字 段 、 参 数 、 变 量 以 及 其 他 实体 的 名 称 一 也 许 你 会 好 奇 这 会 造成 什么 影响 。 很 
幸运 , 事实 上 什么 都 不 需要 担心 。 它 们 都 是 限定 性 关键 字 , 仅 在 语法 期 望 它们 所 在 的 位 置 上 作 
为 关键 字 。 所 以 虽然 不 能 将 变量 命名 为 package 或 者 将 模块 命名 为 byte, 但 是 可 以 将 变量 其 
至 模块 命名 为 module。 





1. 为 模块 命名 
JAR 缺少 的 最 基本 属性 是 编译 顺和 JVM 可 用 来 标识 的 名 称 ， 因 而 这 是 模块 最 显著 的 特征 
你 将 有 机 会 甚至 有 责任 为 每 一 个 创建 的 模块 命名 。 

















O 





要 点 除了 module 关键 字 ， 一 个 模块 声明 在 最 开始 要 为 模块 命名 。 模 块 的 名 称 





潜力 a 
锥 必须 是 一 个 标识 符 ， 这 意味 着 它 必须 使 用 与 诸如 包 名 相同 的 命名 规则 。 模 块 名 通 


常 是 小 写 ， 并 且 是 由 “点 ”分 隔 的 层级 结构 。 


为 模块 命名 是 非常 自然 的 事情 ,因为 你 平时 使 用 的 大 多 数 工具 已 经 要 求 你 为 项 目 命名 。 但 是 
即使 依据 项 目 名 称 为 模块 命名 是 一 个 可 选择 的 方案 ， 明 智 的 命名 选择 也 是 非常 重要 的 ! 

3.2 节 将 提 到 ， 模 块 系统 强烈 地 依赖 模块 的 名 称 。 有 冲突 的 或 不 断 变化 的 名 称 会 造成 麻烦 ， 
此 以 下 两 个 要 点 对 于 模块 名 来 说 非常 重要 : 
口 全 局 唯一 
口 稳定 
最 好 的 命名 方式 是 包 命名 经 常 使 用 的 反 向 域名 命名 法 。 在 加 上 标识 符 的 限制 后 , 得 到 的 模块 
名 通常 是 模块 中 包 的 名 称 前 级 。 该 方式 无 须 强 制 遵守 , 但 这 一 点 很 好 地 揭示 了 这 两 者 都 是 经 过 慎 
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重 选择 的 。 

保持 模块 名 和 包 名 前 级 同步 , 强调 了 模块 名 的 改变 ( 这 暗示 了 包 名 的 改变 ) 是 破坏 性 最 强 的 
改变 之 一 。 从 稳定 性 的 角度 来 说 ， 它 应 该 是 一 个 极其 罕见 的 事件 。 

例如 ， 下 面 的 描述 符 将 模块 命名 为 monitor.statistics ( 为 了 让 名 称 简洁 ， 构 成 ServiceMonitor 
应 用 程序 的 模块 不 遵循 反 向 域名 命名 法 )。 

module monitor.statistics { 

// 省 略 了 frequires 指令 和 exports 指令 

} 

所 有 其 他 属性 都 在 模块 名 后 面 的 花 括号 中 定义 。 这 里 没有 规定 特别 的 顺序 , 但 是 通常 依赖 被 
放置 在 导出 之 前 。 


2. 模块 要 表明 依赖 

JAR 缺失 的 男 一 点 是 声明 依赖 的 能 力 。 因 为 无 法 知道 它们 正常 运行 所 需要 的 其 他 工件 ， 所 
以 人 们 只 能 依赖 构建 工具 或 文档 来 获取 这 些 信息 。 在 模块 系统 中 , 需要 明确 指定 依赖 ( 如 图 3-1 
所 示 )。 









































基于 普通 JAR，JVM 只 能 看 到 基于 模块 系统 ，JVM 在 更 高 层次 
类 之 间 的 关系 进行 抽象 ， 可 以 看 到 模块 间 的 


-去 
大 和 郁 


国 | 让 入 
名 
图 0 UL 


图 3-1 为 表明 模块 间 依赖 引入 了 JVM 可 以 解释 的 一 层 新 的 抽象 。 没 有 模块 间 依 赖 ( 左 )， 
JVM 只 能 看 到 类 型 间 的 依赖 ; 但 是 有 了 模块 间 依赖 ( 右 )， 它 就 能 像 人 们 期 望 的 那 
样 ， 看 到 工件 间 的 依赖 












































定义 : 依赖 
依赖 通过 requires 指令 声明 ， 包 含 了 此 关键 字 以 及 跟 在 其 后 的 模块 名 。 这 个 指令 陈述 ， 
被 声明 的 模块 依赖 于 指定 的 模块 ， 并 在 编译 和 运行 时 需要 它 。 


monitor.statistics 模块 在 编译 时 和 运行 时 都 依赖 于 monitor.observer 模块 ,这 是 通过 requires 
间 令 声明 的 。 
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module monitor.statistics { 
requires monitor.observer; 
// 省 略 了 exports 指令 

} 


通过 requires 指令 声明 了 一 个 依赖 后 , 如 果 模 块 系统 无 法 找到 与 之 完全 同名 的 模块 , 则 会 
抛 出 错误 。 如 果 缺 少 依赖 模块 ， 不 论 编译 还 是 启动 应 用 程序 都 会 失败 〈 人 参见 3.2 家 。 


3. 导出 包 以 定义 模块 API 
最 后 是 导出 指令 , 它 定义 了 模块 的 公有 API。 你 可 以 指定 哪些 包 所 包含 的 类 型 可 被 外 部 模块 
使 用 ， 哪 些 包 只 能 供 内 部 使 用 。 

















定义 : 导出 包 
exports 关键 字 后 面 跟着 该 模块 中 一 个 包 的 名 称 。 只 有 导出 包 可 被 模块 外 部 使 用 ， 所 有 
其 他 的 包 都 被 强 封装 于 模块 内 部 ( 参见 3.3 并 。 


monitor.statistics 模块 导出 了 一 个 同名 的 包 。 


module monitor.statistics { 
requires monitor.observer; 
exports monitor.statistics; 


} 


需要 注意 ， 虽 然 我 们 倾向 于 认为 包 是 层级 结构 的 ， 但 其 实 并 非 如 此 ! java.util 并 不 包含 
java.util.concurrent， 因 此 ， 导出 前 者 并 不 会 公开 任何 后 者 包含 的 类 型 。 这 与 导入 是 一 致 的 ， 
import java.util.x* 会 导入 java.util 中 的 所 有 类 型 ， 但 不 会 导入 java.util.concurrent 


中 的 任何 类 型 ( 如 图 3-2 所 示 )。 














源 代码 根 目 录 
图 java 国 java 
国 org.junitpioneer 国 org.junitpioneerjupiter 
国 jupiter 图 orgjunitpioneervintage 
国 vintage 


很 多 开发 者 ， 包 括 我 自己 ， 会 把 DE 配置 为 将 。 但 是 包 之 间 并 不 相关 ， 即 便 























包 显 示 成 目录 。 看 上 去 org.junitpionee 它们 名 称 的 前 组 部 分 是 相同 
包含 jupiter 和 vintage 的 也 是 如 此 





图 3-2 ”人们 倾向 于 认为 包 是 层级 结构 的 ,就 像 org.junitpioneer 包 含 jupiter 和 vintage 
( 左 )。 但 实际 上 并 不 是 这 样 。Java 只 承认 完整 的 包 名 ， 并 认为 二 者 之 间 没 有 任何 关系 
( 右 )。 导 出 包 时 必须 考虑 这 个 事实 ， 比 如 exports org.junitpioneer 不 会 导出 任 
何 jupiter 或 vintage 中 的 类 型 
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4. 模块 声明 示例 
为 了 实践 ， 先 看 一 下 真实 世界 中 的 模块 声明 。 最 基本 的 模块 是 java.base ， 因 为 它 包 含 了 
java.lang.0bject， 任 何 Java 程序 离开 它 都 无 法 工作 。 它 是 所 有 依赖 的 顶级 依赖 ， 别 的 模块 
都 依赖 它 ， 而 它 什么 都 不 依赖 。 对 java.base 的 依赖 如 此 基础 ， 以 至 于 任何 模块 都 不 需要 明确 声明 
对 它 的 依赖 ， 模 块 系统 会 自动 将 其 填充 到 依赖 模块 中 (更 多 细节 详 见 下 一 节 )。 虽 然 它 什么 都 不 
依赖 ， 但 是 导出 了 多 达 116 个 包 ， 所 以 此 处 只 能 展示 一 个 深度 裁剪 的 版 本 。 
module java.base { 
exports java.lang; 
exports java.math; 
exports java.nio; 
exports java.util; 
// 以 及 更 多 的 exports 指令 
// 省 略 了 一 些 高 级 特性 



































一 个 更 简单 的 模块 是 java.logging， 它 导出 了 java.util.logging 包 。 


module java.logging { 
exports java.util.logging; 


} 


java.rmi 是 某 个 模块 依赖 另 一 个 模块 的 例子 。 它 会 产生 日 志 信息 ， 因 此 依赖 java.logging。 它 
公开 的 API 在 java.rmi 和 以 其 为 前 级 的 其 他 包 中 。 


module java.rmi { 
requires java.logging; 
exports java.rmi; 
// 以 及 其 他 java.rmi.* 包 的 exports 指令 
// 省 略 了 一 些 高 级 特性 
} 




















更 多 例子 请 参阅 2.5 节 , 对 应 用 程序 ServiceMonitor 中 的 模块 进行 声明 的 那些 代码 尤其 如 此 。 


3.1.4 ”模块 的 众多 类 型 


思考 一 下 目前 工作 中 你 正在 开发 的 应 用 程序 。 它 很 有 可 能 包含 一 系列 JAR， 而 这 些 JAR 在 
将 来 的 某 一 时 刻 都 会 是 模块 。 当 然 , 它们 并 不 是 应 用 程序 唯一 的 组 成 部 分 。JDK 也 被 拆 分 成 了 模 
块 ， 而 这 些 模 块 也 将 进入 你 需要 考虑 的 范围 。 但 是 请 等 一 下 ,这 还 并 不 是 全 部 ! 由 于 其 中 一 些 模 
块 所 具有 的 特性 ， 因 此 它们 必须 被 明确 地 调用 。 

















定义 : 模块 类 型 

为 了 避免 混乱 ， 下 面 的 术语 辨识 了 不 同 的 模块 类 型 ， 方 便 后 文 更 加 清晰 地 讨论 模块 世界 。 
是 时 候 坐 下 来 掌握 它们 了 。 不 要 担心 无 法 一 次 性 记 全 。 在 本 页 插入 书签 , 方便 在 遇 到 任何 无 法 
解释 的 术语 时 来 此 查阅 。 
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口 应 用 程序 模块 一 一 非 JDK 模块 ，Java 开发 者 为 自己 的 项 目 创建 的 模块 ， 可 以 是 类 库 、 框 
架 或 者 应 用 程序 。 这 些 模块 存在 于 模块 路 径 中 。 目 前 ， 它 们 特 指 模块 化 JAR (参见 3.1.2 
区。 

口 初始 模块 一 一 最 先 开始 编译 (使 用 javac 命令 ) 的 应 用 程序 模块 或 者 包含 main 函数 (使 
用 java 命令 ) 的 应 用 程序 模块 。5.1.1 节 将 展示 如 何 借助 java 命令 在 启动 应 用 程序 时 指 
定 初始 模块 。 编 译 器 也 依赖 这 个 概念 : 如同 4.3.5 节 中 的 解释 ， 它 指定 了 最 先 开始 编译 的 
模块 。 

口 根 模块 一 一 JPMS 从 此 处 开始 解析 依赖 (3.4.1 节 将 进行 详细 解释 )。 除 了 包含 主 类 或 要 编 
译 的 代码 ， 初 始 模块 同时 也 是 一 个 根 模块 。 随 着 对 本 书 的 深入 阅读 ， 你 会 遇 到 一 些 特殊 
的 状况 ， 需 要 指定 其 他 模块 而 非 初 始 模块 为 根 模块 (3.4.3 节 将 进行 解释 )。 

口 平台 模块 一 一 组 成 JDK 的 模块 ,包含 Java 标准 版 平台 规范 所 定义 的 模块 (以 java. 作 为 前 
级) 和 与 JDK 相关 的 模块 ( 以 jdk. 作 为 前 缀 )。 如 3.1.1 节 中 所 讨论 的 ， 它 们 被 优化 存储 
于 运行 时 libs 目录 的 modules 文件 中 。 

口 晤 化 模块 一 一 非 标 准 的 平台 模块 ， 名 称 以 jdk.incubator 开头 。 它 们 包含 试验 性 API， 有 时 

仿 精 神 的 开发 者 可 以 在 这 些 模块 正式 上 线 前 对 它们 进行 测试 。 

口 系统 模块 一 一 除了 基于 平台 模块 的 子 集 创建 运行 时 镜像 ，jlink 也 可 以 包含 应 用 程序 模 
块 。 包 含 在 这 种 镜像 中 的 平台 模块 和 应 用 程序 模块 被 共同 称 为 它 的 系统 模块 。 它 们 可 以 

通过 在 镜像 的 bin 目录 中 执行 java --list-mogdules 列 出 。 

口 可 见 模块 一 一 当前 运行 时 的 所 有 平台 模块 以 及 通过 命令 行 指定 的 所 有 应 用 程序 模块 。 它 

们 可 以 被 卫 MS 用 来 满足 依赖 。 把 它们 放 在 一 起 ， 就 组 成 了 可 见 模块 全 集 。 

口 基础 模块 一 一 区 分 应 用 程序 模块 和 平台 模块 只 是 为 了 让 沟通 变 得 更 容易 。 对 于 模块 系统 
而 言 ， 所 有 的 模块 都 是 等 同 的 ， 只 有 一 个 例外 : 平台 模块 java.base， 即 所 谓 的 基础 模块 。 
它 扮演 了 一 个 非 同 寻常 的 角色 。 

平台 模块 和 大 多 数 应 用 程序 模块 有 模块 创建 者 给 予 的 模块 描述 符 。 还 有 没有 其 他 形式 的 模 

块 ? 有 。 

口 清晰 模块 一 一 平台 模块 和 大 多 数 应 用 程序 模块 有 模块 创建 者 给 予 的 模块 描述 符 。 

口 自动 模块 一 一 没有 模块 描述 符 的 具名 模块 ( 剧 透 : 模块 路 径 中 的 普通 JAR )。 它 们 是 由 运 

行 时 而 非 开发 者 创建 的 应 用 程序 模块 。 

口 具名 模块 一 一 清晰 模块 和 自动 模块 的 集合 。 这 些 模块 具有 名 称 ， 该 名 称 既 可 以 是 描述 符 

定义 的 ， 也 可 以 是 JPMS 推断 出 的 。 

口 无 名 模块 一 一 没有 名 称 的 模块 ( 剧 透 : 类 路 径 中 的 内 容 )， 因 此 它们 不 是 清晰 模块 。 

自动 模块 和 无 名 模块 都 与 将 应 用 程序 迁移 到 模块 系统 的 过 程 相关 一 一 这 个 话题 将 在 第 8 章 

深入 讨论 。 若 要 更 好 地 理解 这 些 不 同类 型 的 模块 之 间 的 关系 ， 请 参考 图 3-3。 

再 回顾 一 下 第 2 章 探索 过 的 ServiceMonitor 应 用 程序 ， 并 将 其 作为 这 些 术语 的 例子 。 它 包含 

7 个 模块 (monitor 、monitor.observer 、monitorrest， 等 等 )， 外 加 Spark 和 Hibernate 这 样 的 外 部 依 

赖 以 及 相关 的 传递 依赖 。 
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ee 。 应 用 程序 模块 可 以 初始 模块 通常 是 

费 块 都 是 清 踪 目 是 ， 旺 3 0 
一 个 上 定 六 过时 人 可 能 会 旬 站 nn 
今 全 部 平台 模块 ， 所 以 并 非 所 有 平 。 侯 和 人 


人 台 横 块 者 虽 可 见 模块 





CD 





图 3-3 通过 一 个 简单 的 图 表 展示 主要 模块 类 型 : JDK 中 的 模块 称 作 平台 模块 ， 以 基础 
模块 为 核心 ; 然后 是 应 用 程序 模块 ， 其 中 一 个 必须 是 初始 模块 ， 包 含 应 用 程序 
的 main 函数 ( 根 模块 、 系 统 模块 和 及 化 模块 没有 展示 ) 


当 应 用 程序 启动 时 , 通过 命令 行 指定 存放 这 7 个 模块 以 及 依赖 模块 的 目录 。 同 运行 应 用 程序 
的 JRE 或 者 JDK 中 的 平台 模块 一 起 ， 它 们 构成 了 可 见 模块 全 集 。 模 块 系统 会 从 这 些 模块 中 寻找 
合适 的 模块 来 满足 依赖 。 

ServiceMonitor 的 各 个 模块 以 及 它们 的 依赖 模块 一 一 Hibernate 和 Spark， 都 属于 应 用 程序 模 
块 。 因 为 包含 main 函数 ， 所 以 monitor 是 初始 模块 ， 并 且 不 再 需要 其 他 根 模 块 。 程 序 唯一 直接 
依赖 的 平台 模块 是 基础 模块 java.base， 但 是 Hibernate 和 Spark 引入 了 其 他 模块 ， 比 如 java.sql 和 
java.xml。 由 于 这 是 一 个 全 新 的 应 用 程序 ， 所 有 的 依赖 都 是 模块 化 的 ， 因 此 这 并 不 是 一 个 迁移 场 
景 ; 由 于 同样 的 原因 ， 它 也 没有 涉及 自动 模块 和 无 名 模块 。 

在 了 解 了 不 同类 型 的 模块 以 及 它们 的 声明 后 ， 是 时 候 探 索 Java 如 何 处 理 此 信息 了 。 


3.2 可 读 性 : 连接 所 有 片段 


模块 是 模块 化 应 用 程序 的 基石 : 交互 工件 图 中 的 节点 。 但 是 如 果 没 有 连接 节点 的 边 ， 就 不 能 
构成 图 ! 这 就 是 可 读 性 的 意义 一 一 基于 它 ， 模 块 系统 将 为 节点 之 间 创 建 连接 。 





定义 : 可 读 性 边 

当 模 块 customer 声 明了 需要 bar, 在 运行 时 customer 会 读 取 bar, 或 反 过 来 ,bar 将 对 customer 
可 读 (如 图 3-4 所 示 )。 这 两 个 模块 之 间 的 连接 称 作 可 读 性 边 (readability edge )， 简 称 为 读 取 
边 (reads edge )。 
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customer 模 块 声明 了 对 
bar 模 块 的 依赖 





JPMSiFcustomer 
模块 读 取 bar 模 块 


customer 
1 reads 
module customer { 
. 
J 








图 3-4 customer 模块 的 描述 符 中 声明 了 对 bar 模块 的 依赖 时 。 基 于 此 ,模块 
系统 会 让 customer 在 运行 时 读 取 bar 旨 


像 “customer 需要 bar” 和 “customer 依赖 bar” 这 样 的 短语 反映 了 customer 和 bar 之 间 的 静 
态 编译 时 关系 ,可 读 性 则 反映 了 更 加 动态 的 、 运 行 时 的 对 应 内 容 。 为 什么 它 更 加 动态 呢 ? 
requires 指令 是 可 读 性 边 的 最 初 发 起 者 , 但 这 并 不 意味 着 它 是 唯一 的 发 起 者 ， 其 他 发 起 者 还 包 
括 命令 行 选项 (参见 3.4.4 节 中 的 --add-reads ) 以 及 反射 API ( 参见 12.3.4 节 ), 二 者 都 可 以 被 
用 来 增加 更 多 的 可 读 性 边 。 最终 , requires 指令 的 作用 将 被 弱化 ,不论 可 读 性 边 是 如 何 创 建 的 ， 
































它们 的 效果 都 是 一 样 的 
3.2.1 ”实现 可 靠 配 置 


成 为 可 徘 配置 和 可 访问 怕 











的 基础 (参见 3.3 前 。 














如 1.5.1 节 所 述 ， 可 靠 配置 由 在 保证 Java 程序 编译 或 启动 所 用 的 工件 配置 正确 ， 而 这 样 的 配 
置 可 以 帮助 程序 避免 运行 时 错误 。 为 了 达到 这 个 目的 , 它 会 进行 一 系列 检查 ( 在 模块 解析 过 程 中 ， 


即 3.4.1 节 解 释 的 过 程 )。 








要 点 模块 系统 检查 可 见 模块 全 集 是 否 
赖 ， 缺少 任何 依赖 都 会 报错 。 而 且 ， 其 中 不 能 有 任何 歧义 ， 比如 不 能 出 现 两 个 


包含 了 所 有 需要 的 直接 依赖 或 传递 依 


工件 声称 它们 是 同一 个 模块 的 情况 。 当 某 个 模块 存在 不 同 版 本 时 ， 这 就 会 变 得 
很 有 趣 : 因为 模块 系统 没有 版 本 的 概念 ( 参见 第 13 章 )， 它 会 认为 它们 是 重复 
模块 ， 所 以 模块 系统 会 报错 。 模 块 之 间 不 能 有 静态 依赖 环 。 在 运行 时 ， 模 块 之 
间 有 可 能 其 至 有 必要 互相 访问 ( 比如 使 用 Spring 注解 的 代码 ，Spring 会 反射 这 
些 代 码 ), 但 它们 之 间 绝 不 能 有 编译 依赖 (很 显然 Spring 不 能 对 其 反射 的 代码 进 
行 编译 )。 包 必须 有 唯一 的 来 源 ， 这 样 就 不 会 出 现 两 个 模块 分 别 包 含 同 一 个 包 中 
的 类 型 的 情况 。 这 种 情况 称 为 包 分 裂 ， 模 块 系统 会 拒绝 编译 或 启动 这 样 的 配置 。 
这 对 迁移 过 程 而 言 会 非常 有 趣 ， 因 为 一 些 现 有 的 类 库 或 框架 会 故意 对 包 进 行 分 
裂 (参见 7.2 节 )。 


这 个 验证 并 非 万 无 一 失 , 它 有 可 能 让 问题 隐藏 很 长 时 间 ,， 使 运行 中 的 程序 崩溃 。 例 如 ， 如 果 








一 个 模块 的 错误 版 本 被 放 到 了 正确 的 位 置 , 那么 应 用 程序 会 启动 ( 因为 所 有 的 依赖 模块 都 存在 )， 
但 之 后 在 访问 某 个 缺失 的 类 或 方法 时 它 会 月 溃 。 
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因为 模块 系统 的 主旨 是 在 编译 时 和 运行 时 展现 一 致 的 行为 , 所 以 可 以 基于 同样 的 工件 来 编译 
和 启动 ， 以 进一步 避免 可 能 的 错误 。( 在 例子 中 ， 用 模块 的 错误 版 本 进行 的 编译 会 失败 。) 


3.2.2 ”用 不 可 靠 配 置 进行 实验 


现在 试 着 搞 一 些 破 坏 。 模 块 系统 会 检测 出 哪些 不 可 靠 配置 ?为 了 便于 调查 ,请 回 到 第 2 章 提 
到 的 ServiceMonitor 应 用 程序 。 


1. 依赖 缺失 
看 一 下 monitor.observer.alpha 和 它 的 声明 。 


























module monitor.observer.alpha { 
requires monitor.observer; 
exports monitor.observer.alpha; 


} 


在 编译 时 ， 如 果 缺 失 monitorobserver 依赖 ， 会 抛 出 如 下 错误 。 


> monitor.observer.alpha/src/main/java/module-info.java:2: 

















> error: module not found: monitor.observer 
> requires monitor.observer 
a 和 和 


> 1 error 





如 果 该 依赖 在 编译 时 存在 ， 但 在 启动 时 丢失 ， 则 JVM 会 退出 并 报 出 以 下 错误 。 


> Error occurred during initialization of boot layer 
> java.lang.module.FindException: 









































> Module monitor.observer not foungd, 
> required by monitor.observer.alpha 
虽然 对 于 所 有 传递 依赖 而 言 在 运行 时 进行 强制 检查 是 有 意义 的 ， 但 对 编译 器 而 言 并 非 如 此 。 




















因此 ， 如 果 缺 少 间接 依赖 关系 ， 编 译 器 既 不 会 发 出 警告 ， 也 不 会 提示 错误 ， 来 看 以 下 示例 。 
下 面 是 monitorpersistence 和 monitor.statistics 的 模块 声明 。 

















module monitor .Persistence { 
requires monitor.statistics; 
exports monitor.persistence; 


} 


module monitor.statistics { 
requires monitor.observer; 
exports monitor.statistics; 


} 


很 明显 monitor.persistence 并 不 直接 依赖 monitor.observer， 所 以 即使 monitor.observer 在 模块 
路 径 中 不 存在 ，monitorpersistence 也 能 编译 成 功 。 
缺少 传递 依赖 的 应 用 程序 是 无 法 启动 的 。 即 使 初始 模块 并 没有 直接 依赖 于 缺失 项 , 但 是 只 要 
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有 模块 依赖 它 , 该 情况 仍然 会 被 报告 为 依赖 缺失 。 代 码 库 ServiceMonitor 中 的 break-missing- 
transitive-dependency 分 支 创建 了 一 个 配置 示例 ， 展 示 了 缺失 依赖 模块 而 导致 运行 错误 的 
情况 。 


2. 重复 模块 

因为 模块 是 通过 名 称 相互 引用 的 , 所 以 任何 情况 下 ， 只 要 两 个 模块 具有 相同 的 名 称 ， 就 会 引 
起 此 义 。 判 断 哪 一 个 模块 正确 非常 依赖 于 上 下 文 环 境 ， 而 这 通常 并 不 是 模块 系统 可 以 决定 的 。 因 
此 ,为 了 避免 做 出 错误 的 决定 , 模块 系统 选择 不 做 任何 决定 ,而 是 产生 错误 信息 。 这 种 快速 失败 
的 方式 能 让 开发 人 员 注 意 到 问题 并 进行 修复 ， 而 不 是 放任 错误 的 发 生 。 

下 面 是 一 个 编译 错误 。 它 产生 的 原因 是 ,模块 系统 尝试 使 用 模块 路 径 上 两 个 同名 的 


monitor.observer.beta 依赖 。 















































> error: duplicate module on application module path 
> module in monitor.observer.beta 
> 1 error 


请 注意 ,编译 如 无 法 将 错误 指向 编译 中 的 某 个 文件 ， 因 为 这 不 是 错误 的 原因 。 相 反 ， 模块 路 
径 上 的 工件 才 是 导致 错误 的 原因 。 

如 果 JVM 在 启动 时 检测 到 错误 ， 它 会 提供 更 为 准确 的 信息 ， 其 中 列 出 了 JAR 文件 名 。 
Error occurred during initialization of boot layer 
java.lang.module.FindException: 


Two versions of module monitor.observer.beta found in mods 
(monitor.observer.beta.jar and monitor.observer.gamma .jar) 


正如 1.6.6 节 讨论 的 那样 (13.1 节 将 深入 探讨 )， 由 于 模块 系统 没有 版 本 的 概念 ， 因 此 在 这 种 
情况 下 会 出 现 类 似 的 错误 。 这 是 一 个 很 好 的 推测 : 绝 大 多 数 模块 重复 错误 的 原因 是 模块 路 径 上 存 
在 同一 模块 的 多 个 版 本 。 


要 点 ”歧义 检查 仅 适 用 于 单个 模块 路 径 的 情况 。( 这 向 话 可 能 会 让 你 抓 耳 找 肋 
3.4.1 节 会 进行 详细 解释 。 这 里 先 提 一 下 ， 以 免 遗 漏 这 个 重要 的 事实 。) 


即使 没有 被 引用 ， 只 要 模块 路 径 中 有 重复 模块 , 模块 系统 也 会 抛 出 模块 重复 错误 。 导致 该 现 
象 的 其 中 两 个 原因 是 服务 和 可 选 依赖 , 第 10 章 和 11.2 节 将 详细 介绍 它们 。 代码 库 ServiceMonitor 
的 preak-duplicate-modules-even-if-unrequired 分 支 展 示 了 重复 模块 导致 的 报错 信 
上 息 ， 即 使 该 模块 没有 被 引用 也 是 如 此 。 


3. 循环 依赖 

创建 循环 依赖 很 容易 , 但 让 它们 通过 编译 很 难 , 要 直截了当 地 把 它们 呈现 给 编译 器 也 并 非 易 
事 。 为 了 做 到 这 一 点 ， 必 须 先 解决 “ 鸡 生 和 蛋 蛋 生 鸡 ”的 问题 : 如 果 两 个 项 目 相互 依赖 ， 就 不 可 能 
在 缺少 一 个 项 目的 情况 下 编译 另外 一 个 。 如 果 你 尝试 过 ,就 会 遇 到 缺少 依赖 的 问题 并 收 到 对 应 的 
错误 提示 。 
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解决 这 个 问题 的 一 种 方法 是 同时 编译 两 个 模块 ， 即 同时 着 手 于 “ 鸡 和 和 蛋 ”。4.3 节 将 对 此 做 详 
细 曾 述 。 可 以 这 么 说 ， 如 果 正 在 编译 的 模块 之 间 存 在 循环 依赖 ， 那 么 模块 系统 会 识别 出 来 ， 并 报 
告 编译 错误 。 下面 的 示例 展示 了 因 monitorpersistence 和 monitor.statistics 互相 依赖 而 导致 的 错误 。 


> monitor.statistics/src/main/java/module-info.java:3: 
> error: cyclic dependence involving monitor.persistence 
> requires monitor.persistence; 


入 














> 
> 1 error 


另 一 种 方法 是 , 在 构建 有 效 配置 之 后 不 立即 建立 循环 依赖 ， 而 是 随 着 时 间 推 移 逐 渐 建 立 。 再 


次 回 到 monitor.persistence 和 monitor.statistics。 

















module monitor.persistence { 
requires monitor.statistics; 
exports monitor.persistence; 


} 


module monitor.statistics { 
requires monitor.observer; 
exports monitor.statistics; 


} 

这 个 配置 是 正确 的 ， 而 且 能 编译 成 功 。 接 下 来 ， 奇 妙 的 事情 发 生 了 : 编译 模块 并 保留 JAR， 
然后 将 monitor.statistics 中 的 模块 声明 更 改 为 依赖 monitorpersistence, 这 会 创建 一 个 循环 依赖 ( 此 
示例 中 的 更 改 没 有 多 大 意义 ， 但 在 更 复杂 的 应 用 程序 中 通常 会 这 样 做 )。 


module monitor .statistics { 
requires monitor.observer; 






























































requires monitor.persistence; 
exports monitor.statistics; 
} 
下 一 步 是 在 模块 路 径 上 将 已 编译 过 的 模块 和 更 改 后 的 monitor.statistics 一 块 重新 编译 。 这 其 
中 肯定 包含 了 monitor.persistence, 基 为 ”monitor.statistics 模块 现在 依赖 它 . 相 反 ,monitorpersistence 
模块 依然 声明 了 它 对 monitor.statistics 的 依赖 ， 这 就 是 这 个 循环 依赖 的 后 半 部 分 。 很 遗憾， 一 番 
操作 之 后 ， 模 块 系统 还 是 发 现 了 循环 依赖 问题 ， 并 抛 出 了 与 之 前 相同 的 编译 错误 。 
现在 是 时 候 展 现 真正 的 技术 了 : 用 一 个 更 高 明 的 手段 来 “欺骗 ”编译 器 。 在 本 场景 中 ,要 用 
两 个 完全 不 相关 的 模块 一 一 比如 选择 monitor.persistence 和 monitor.rest 一 一 各 自 编译 成 JAR, 之 
后 就 是 关键 部 分 。 
新 增 第 一 个 依赖 ， 比 如 使 persistence 依赖 rest， 并 且 更 改 后 的 persistence 基于 原 有 的 模块 集 
进行 编译 。 它 能 编译 成 功 ， 因 为 原 有 模块 集中 的 rest 并 不 依赖 persistence。 
新 增 第 二 个 依赖 ,即使 rest 依赖 persistence, 但 是 让 更 改 后 的 rest 也 基于 原 有 的 模块 集 编译 ， 
其 中 包含 的 persistence 模块 是 修改 前 的 、 尚 未 依赖 rest 的 版 本 ， 因 此 也 能 编译 成 功 。 
是 不 是 把 你 弄 糊 涂 了 ?那么 看 一 下 图 3-5， 它 从 男 外 一 个 视角 进行 了 解读 。 
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1 编译 一 个 依赖 rest 
的 persistence 版 本 


statistics > 


persistence 
rest 


persistence 









rest 


persistence 





persistence 


statistics < 人 statistics 


于] 











现在 使 用 新 编译 的 persistence ~ 着 编译 rest， 但 是 基于 旧 的 persistence 
3 和 rest 模 块 来 启动 应 用 程序 2 版 本 ， 这 样 编译 器 就 无 法 看 到 循环 依赖 
的 存在 了 




















3-5 让 循环 依赖 通过 编译 并 不 容易 ， 这 里 通过 选择 两 个 互 不 依赖 的 模块 : persistence 和 
rest( 均 依 赖 于 statistics )， 然 后 分 别 添 加 从 一 个 到 另外 一 个 的 依赖 来 达到 目的 ， 其 
中 最 重要 的 是 基于 旧 的 persistence 来 编译 rest， 这 样 不 会 有 循环 依赖 的 问题 ， 编 译 
可 以 通过 。 在 最 后 一 步 中 ， 两 个 旧 的 模块 都 可 以 用 新 编译 的 模块 替换 ， 而 新 模块 之 
间 具 有 循环 依赖 关系 


于 是 现在 , 我 们 有 了 monitorpersistence 和 monitorrest 模块 的 不 同 版 本 , 它们 之 间 相 互 依赖 。 
如 果 这 一 切 发 生 在 现实 世界 中 , 那么 编译 过 程 ( 可 能 由 构建 工具 管理 ) 一 定 会 产生 严重 的 混乱 ( 这 
并 非 前 所 未 闻 )。 幸 好 ， 当 在 这 种 配置 环境 下 启动 JVM 后 ， 模 块 系统 会 帮助 你 并 报告 如 下 错误 。 

> Error occurred during initialization of boot layer 

> java.lang.module.FindException: 

过 Cycle detected: 
monitor.persistence 


-> monitor.rest 
-> monitor.persistence 


尽管 所 有 示例 展示 的 都 是 两 个 工件 之 间 的 循环 依赖 关系 , 但 是 模块 系统 会 进一步 检测 所 有 循 
环 依赖 关系 。 这 确实 很 棒 ! 代码 变更 总 有 破坏 上 游 功能 的 风险 ,因为 上 游 功能 中 的 代码 可 能 直接 
或 间接 地 调用 了 被 改动 的 代码 。 

如 果 依 赖 关系 只 在 一 条 直线 上 延续 , 那么 发 生 改变 时 只 会 影响 这 条 线 上 的 代码 。 与 此 相应 的 
是 , 如果 依赖 关系 形成 了 一 个 循环 , 那么 该 循环 中 的 所 有 代码 以 及 依赖 于 它 的 所 有 代码 都 会 受到 
影响 。 特别 是 如 果 循 环 范围 非常 大 ,那么 很 快 所 有 代码 都 会 受到 影响 , 不必 说 ,这 种 情况 一 定 要 
避免 。 幸 好 ， 不 只 模块 系统 能 帮助 你 ， 构 建 工 具 也 可 以 ， 它 也 是 处 理 循环 依赖 的 好 帮手 。 
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4. 包 分 裂 

当 两 个 模块 在 同名 包 中 含有 相同 的 类 型 时 ， 就 会 发 生 包 分 裂 ( split package )。 举 个 例子 ， 还 
记得 monitor.statistics 模块 的 monitor.statistics 包 中 包含 Statistician 类 吧 。 现 在 假设 
monitor 模块 中 有 一 个 它 的 简单 实现 SimpleSstatistician。 为 了 保持 一 致 性 ， 该 实现 位 于 
monitor 的 monitor.statistics 包 中 。 

当 尝 试 编译 monitor 模块 时 ， 编 译 器 会 提示 如 下 错误 。 

> monitor/src/main/java/monitor/statistics/SimpleStatistician.java:1l: 


> error: package exists in another module: monitor.statistics 
> package monitor.statistics; 




















要 点 ”有趣 的 是 ， 只 有 当 编 译 中 的 模块 可 以 访问 另 一 个 模块 中 分 裂 的 包 时 ， 编 译 
器 才 会 提示 错误 。 这 表明 分 裂 的 包 必 须 被 导出 。 


现在 尝试 另外 一 种 方式 :假设 Simplestatistician 不 再 存在 ,并 且 这 回 让 monitor.statistics 
创建 分 裂 的 包 。 为 了 方便 复 用 一 些 工具 方法 , 在 monitor 包 中 创建 Utils 类 。 由 于 不 希望 与 其 
他 模块 共享 该 类 ， 因 此 模块 仍然 只 导出 monitor.statistics 包 。 

于 是 我 们 可 以 顺利 地 编译 monitor statistics ， 这 是 有 道理 的 ， 因 为 它 不 依赖 于 monitor， 因 此 
也 就 不 会 意识 到 包 分 裂 。 当 编译 monitor 的 时 候 事情 变 得 有 趣 了 ， 它 依赖 于 monitor.statistics， 并 
且 二 者 的 monitor 包 中 都 包含 同样 的 类 型 。 但 是 ， 就 像 前 文 提 到 的 ， 因 为 monitor statistics 没有 
导出 相关 的 包 ， 所 以 编译 通过 。 

好 极 了 ! 是 时 候 局 动 它 了 。 

> Error occurred during initialization of boot layer 


> java.lang.reflect.LayerIinstantiationException: 
> Package monitor in both module monitor.statistics and module monitor 


情况 好 像 还 是 不 太 对 。 在 启动 时 , 模块 系统 会 检查 包 分 裂 ， 而 且 该 检查 与 这 这 些 包 是 否 被 导出 
无 关 : 不 允许 两 个 模块 包含 同一 个 包 中 的 类 型 。 正 如 你 将 在 7.2 节 中 看 到 的 那样 ， 这 会 导致 将 代 
码 迁 移 到 Java 9 时 出 现 问 题 。 

ServiceMonitor 代码 库 分 别 展示 了 编译 时 和 运行 时 的 包 分 裂 问题 ， 对 应 的 分 支 是 


break-split-package-compilation 和 break-split-package-launcho 


5. 模块 的 死亡 之 眼 
一 个 非常 极端 的 融合 了 包 分 裂 和 依赖 缺失 的 场景 称 为 模块 的 死亡 之 眼 (modular diamond of 
death ) 如 图 3- 6 )。 假设 某 个 模块 在 新 版 本 中 修改 了 名 称 ， 即 一 个 依赖 通过 旧名 称 引 用 该 模 
块 ,， 而 男 一 个 依赖 通过 新 名 称 引 用 该 模块 。 现在, 你 需要 让 相同 的 代码 显示 在 两 个 不 同 的 模块 名 
称 下 ， 然 而 JPMS 是 不 会 让 这 种 情况 发 生 的 。 
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同一 个 项 目的 两 个 
不 同 版 本 使 用 了 两 ”它们 经 
\ 同 的 模块 名 称 ” 模 


配置 下 启动 









图 3-6 如 果 


如 有 果 两 个 版 本 同时 使 用 ， 
] 会 互相 影响 ， 因 为 
系统 不 允许 在 这 种 














RR 一 个 模块 更 改 了 名 称 ( 如 图 ， 从 jackson 改 为 johnson ), 那么 依赖 两 个 版 本 的 项 


目 (如 图 ,项目 app 分 别 通过 frame 和 border 产生 依赖 ) 最 终 可 能 会 面临 模块 的 死 


亡 之 上 腿 ， 因 为 它们 依赖 于 同一 个 项 目 


你 会 遇 到 以 下 两 种 情况 之 一 。 
口 一 个 模块 化 JAR 只 能 
口 














要 点 ”应 该 不 惜 一 切 代价 避免 这 种 情况 ! 如 果 要 发 布 菜 个 工件 到 4 





这 个 项 目 却 有 着 两 个 不 同 的 名 称 


以 一 个 名 称 作为 模块 出 现 。 因 此 无 法 满足 依赖 ， 从 而 导致 错误 。 
两 个 模块 化 JAR 具有 不 同 的 名 称 却 包含 相同 的 包 ， 这 将 导致 上 文中 提 到 的 包 分 裂 错误 。 


公共 仓库 ， 你 应 


该 仔细 考虑 是 否 有 必要 对 模块 进行 重 命名 。 如 果 有 必要 , 你 可 能 还 需要 修改 包 名 ， 
以 方便 其 他 人 同时 使 用 新 旧 模 块 。 如 果 以 用 户 的 身份 遇 到 这 种 情况 ， 那 么 你 可 以 


问题 。 


3.3 可 访问 性 : 定义 公有 API 


了 解 了 模块 和 可 读 边 , 你 就 已 经 了 解 了 模块 系统 如 何 构建 心中 的 模块 


问 性 〈accessibility ) 的 由 来 。 


创建 聚合 器 模块 (参见 11.1.5 节 ) 或 编辑 模块 描述 符 (参见 9.3.3 节 ) 来 解决 这 一 





图 。 为 了 避免 模块 图 陷 


入 “大 泥 球 ” 困 境 ， 这 里 有 一 个 新 的 需求 : 隐藏 模块 内 部 细节 ， 阻 止 外 部 代码 访问 。 这 就 是 可 访 


定义 : 可 访问 性 


( 如 图 3-7 所 示 )。 


当 以 下 条 件 均 得 到 满足 时 ， 模 块 bar 中 的 类 型 Drink 对 于 模块 customer 而 言 是 可 访问 的 


口 Drink 是 公有 的 。 
口 Drink 所 属 的 包 被 导出 。 
口 customer 读 取 bar。 





3.3 可 访问 性 : 定义 公有 API 61 





Drink 类 是 公有 的 …… 










e000s 并 日 位 于 它 曾 的 模块 bar 中 的 
age 包 是 已 导出 的 …… 

















和 所 以 当 其 他 模块 读 取 bar 时 ……' 





customer 










beverage 







Drink 
order() 
drink() 





can access 














isa 是 可 以 访问 Drink 的 
图 3-7 在 模块 bar 中 ， 某 个 已 导出 的 包 回 中 包含 公有 的 类 型 Drink 国 ， 并 且 模 块 customer 
读 取 模块 bar 图 ， 因 此 这 3 点 满足 customer 中 的 代码 访问 Drink 的 所 有 要 求 。 想 
知道 如 果 有 条 件 不 满足 时 会 发 生 什 么 吗 ? 请 查阅 3.3.3 节 











对 于 可 访问 类 型 的 成 员 ( 即 它 的 字段 、 方 法 和 嵌 套 类 ) 而 言 ， 常 见 的 可 见 性 规则 包含 : 公有 


成 员 是 完全 可 访问 的 , 而 受 保护 的 成 员 仅 可 由 继承 类 访问 。 从 技术 上 来 说 , 还 有 同一 个 包 中 能 访 
问 的 包 私 有 成 员 ， 但 是 正如 上 一 节 所 述 ， 由 于 跨 模块 包 分 裂 规则 的 存在 ， 这 一 可 见 性 是 无 效 的 。 

















注意 ”可 访问 性 的 定义 指出 要 有 读 取 该 类 型 的 模块 。 从 这 个 意义 上 来 说 ， 一 个 类 型 永远 
不 会 是 “可 访问 ”的 ， 它 只 是 “对 于 特定 模块 而 言 是 可 访问 的 ”。 但 是 ， 通 常 即使 没有 其 
他 模块 来 读 取 ， 只 要 类 型 是 公有 的 且 在 一 个 已 导出 的 包 中 ， 人 们 就 说 它 是 可 访问 的 。 这 
是 因为 对 于 一 个 类 型 来 说 ， 任 何 模块 都 可 以 读 取 和 包含 它 的 模块 ， 从 而 自由 地 访问 该 类 型 。 
想 知 道 可 访问 性 如 何 形成 模块 的 公有 API， 先 要 理解 这 个 术语 : 什么 是 公有 API (public 
API)? 
定义 : 公有 API 
用 非 技 术 术 语 来 解释 ， 模 块 的 公有 API 不 能 被 变更 ， 否 则 必然 导致 引用 它 的 代码 发 生 编 
译 错误 。( 一 般 而 言 ， 该 术语 还 规范 了 运行 时 的 行为 ， 但 是 由 于 模块 系统 不 在 该 维度 中 运行 ， 
因此 本 书 忽 略 了 它 。) 从 技术 上 解释 ， 模 块 的 公有 API 由 以 下 几 部 分 组 成 : 
口 导 出 包 中 所 有 公有 类 型 的 名 称 ; 
口 公 有 字段 和 受 保护 字段 的 名 称 和 类 型 名 称 ; 
口 所 有 公有 和 受 保护 方法 的 名 称 、 参 数 类 型 名 称 和 返回 类 型 名 称 ( 人 们 称 之 为 方法 签名 )。 
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如 果 党 得 突然 开始 讨论 名 称 很 奇怪 , 那么 想 一 想 你 可 以 改变 类 型 中 的 哪些 部 分 , 并 同时 保持 
外 部 的 依赖 代码 始终 能 编译 通过 。 私 有 和 包 可 见 的 字段 ? 当然 。 私 有 和 包 可 见 的 方法 ? 没 错 。 公 
有 方法 的 实现 ?是 的 。 需要 保持 不 变 的 是 其 他 代码 编译 中 依赖 的 所 有 名 称 : 类 型 的 名 称 、 公 有 方 
法 的 签名 ， 等 等 。 

查看 公有 API 的 定义 ， 很 容易 发 现 模块 系统 从 Java 9 开始 在 包 ( 必须 是 导出 的 ) 和 类 型 〈 必 
须 是 公有 的 ) 的 级 别 上 进行 了 更 改 。 而 类 型 内 部 是 没有 变化 的 。 类 型 的 公有 API 在 Java 8 与 Java9 
及 更 高 版 本 中 均 是 相同 的 。 






































3.3.1 实现 强 封 装 


要 点 ”如果 某 个 类 型 不 可 访问 ， 就 表示 无 法 以 任何 与 其 相关 的 形式 与 该 类 型 进行 
交互 : 你 无 法 实例 化 它 、 无 法 访问 它 的 字段 、 无 法 调用 它 的 方法 ， 也 无 法 使 用 它 
的 上 诸 套 类 。 “与 其 相关 的 形式 ”这 一 表述 或 许 有 点 奇怪 。 其 含义 是 什么 ? 在 一 些 
特殊 情况 下 ， 是 可 以 与 该 类 型 的 成 员 进 行 交 互 的 : 如 果 这 些 成 员 定 义 在 一 个 可 访 
问 的 超 类 ， 比 如 该 类 型 实现 的 接口 甚至 Object 类 中 。 这 非常 像 在 Java 9 之 前 ， 
一 个 公有 接口 的 非 公有 实现 是 可 以 被 使 用 的 ， 但 是 只 能 通过 该 接口 来 使 用 。 


以 高 性 能 库 superfast 为 例 ， 它 是 一 个 已 知 Java 集合 类 的 定制 化 实现 。 关 注 一 个 假想 的 
SuperfastHashMap 类 , 它 实 现 了 Java 中 的 Map 接口 并 且 是 不 可 访问 的 (不 可 访问 的 原因 可 能 
是 它 仅 在 包 级 别 可 见 ， 也 可 能 是 其 所 在 的 包 根 本 就 没 导出 )。 

如 果 superfast 模块 外 的 代码 获得 了 一 个 superfastHashMap 的 实例 ( 也许 是 通过 工厂 的 方 
式 获 得 )， 那 么 它 仅 限 于 以 Map 的 方式 使 用 : 既 不 能 把 它 分 配给 一 个 superfastHashMap 类 型 
的 变量 ， 也 不 能 让 其 调用 superfastGet 方法 ( 即便 该 方法 是 公有 的 )。 但 是 在 它 所 实现 的 超 类 
( 即 Map， 乃至 object ) 上 定义 的 一 切 功能 都 是 可 以 使 用 的 ( 如 图 3-8 所 示 )。 

可 访问 性 规则 让 人 们 可 以 在 很 好 地 封装 模块 内 部 的 同时 , 公开 精心 选择 的 功能 , 确保 外 部 代 
码 不 依赖 于 内 部 实现 的 细节 。 有 趣 的 是 , 在 跨 模 块 场景 下 , 即使 是 反射 也 无 法 绕 过 这 个 规则 ! (本 
章 剩 下 的 部 分 将 讨论 “反射 ”这 一 特性 一 一 如 果 需 要 了 解 更 多 的 基础 知识 ， 请 参考 附录 B。 ) 
也 许 你 想 知 道 诸如 Spring、Guice 、Hibernate 等 基于 反射 的 库 在 未 来 如 何 工 作 ， 或 者 在 必要 
时 代码 如 何 打破 模块 系统 的 可 访问 性 规则 。 下 面 介 绍 几 种 可 以 提供 或 者 获取 访问 权限 的 方式 : 
口 常规 的 导出 方式 (参见 3.1 区 ; 

口 合 规 导 出 (参见 11.3 欧 ; 
口 开放 式 模块 和 开放 式 包 (参见 12.2 区 ; 
口 命令 行 选项 (参见 7.1 节 中 的 总 结 )。 
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java.base 





requires 
and reads 
所 有 其 他 代码 
可 以 访问 





requires 
and reads 


可 以 访问 和 实现 








> 
requires | superfast 


ndr | i 
and reads superfast.internal superfast.api 


MapFactory 








SuperfastHashMap 
superfastGet() 














无 法 访问 ， 
只 能 以 Map | 交 ER 


的 形式 使 用 








CS 





可 以 访问 





可 以 访问 以 创建 Map 实 例 








未 导出 的 包 

图 3-8 ”对 外 不 可 访问 的 类 型 superfastHashMap 实现 了 可 访问 的 接口 Map。 模块 superfast 外 的 
代码 如 果 持 有 一 个 SuperfastHashMap 的 实例 ， 则 只 能 以 ap 或 者 Object 的 实例 使 用 ， 
任何 SuperfastHashMap 中 的 特性 均 无 法 使 用 ， 比 如 调用 superfastGet 方法 。 但 是 
模块 superfast 内 的 代码 不 受 可 访问 性 的 限制 , 可 以 正常 地 使 用 superfastHashMap 这 一 
类 型 ， 比 如 创建 它 的 实例 并 且 返 回 等 


第 12 童 将 深入 探索 分 析 反 射 机 制 。 


但 是 ， 先 回 到 满足 可 访问 性 的 3 个 条 件 (公有 类 型 、 已 导出 的 包 和 访问 模块 )， 或 许 能 形成 
一 些 有 趣 的 结论 。 












































要 点 一 方面 , public 访问 修饰 符 并 不 代表 着 类 型 一 定 是 公有 的 。 只 查看 类 型 的 
声明 , 已 经 不 可 能 知道 它 在 模块 外 部 是 否 可 见 了 ， 因 为 还 需要 查看 module-info. 
java， 或 者 依靠 IDE 将 已 经 导出 的 包 或 类 型 高 亮 显示 。 同 时 ， 如 果 没 有 使 用 
requires 关键 字 , 那么 一 个 模块 中 的 所 有 类 型 都 无 法 被 外 部 访问 。 从 现在 开始 ， 
封装 是 新 的 默认 属性 ! 


这 3 个 条 件 也 意味 着 你 不 会 再 意外 地 依赖 于 传递 依赖 ， 下 面 来 看 看 原因 。 
3.3.2 ”封装 传递 依赖 


如 果 没 有 模块 系统 ， 则 可 以 引入 JAR 中 的 类 型 但 不 声明 依赖 。 一 旦 以 这 种 方式 使 用 类 型 ， 
构建 的 配置 就 不 再 反应 真实 的 依赖 关系 集合 ， 这 可 能 导致 不 明确 的 架构 决策 乃至 运行 时 错误 。 
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举 个 例子 ， 假 设 一 个 项 目 使 用 了 Spring， 并 且 Spring 依赖 于 OkHttp。 在 写 代码 的 时 候 使 用 
OkHttp 中 的 类 型 是 非常 简单 的 一 件 事 ， 只 要 按照 IDE 给 出 的 建议 添加 导入 语句 即 可 。 同 时 ， 这 
些 代码 很 容易 通过 编译 并 且 运 行 起 来 , 因为 构建 工具 会 处 理 好 Spring 以 及 它 的 全 部 依赖 ( 其 中 就 
包括 OkHttp )， 保 证 它们 在 需要 的 时 候 出 现 。 这 种 便利 使 得 人 们 没 必要 声明 项 目 对 OkHttp 的 依 
赖 ， 也 就 使 得 人 们 经 常 忘 记 了 这 样 的 依赖 关系 ( 如 图 3-9 所 示 )。 


普通 JAR | 模块 






























requires 
and reads 


OkHttp 


3-9 如 果 没 有 模块 ， 代 码 很 容易 在 不 经 意 间 依赖 到 传递 依赖 上 ， 就 像 图 中 的 例子 一 
样 : 应 用 程序 依赖 OkHttp， 而 这 个 依赖 是 由 Spring 引入 的 。 男 一 方面 ， 有 了 
模块 ,必须 使 用 requires 关键 字 来 声明 依赖 关系 才能 访问 它们 。 图 中 的 应 月 
程序 没有 声明 对 OkHttp 的 依赖 ， 因 此 无 法 访问 它 


这 造成 的 结果 是 , 项 目的 依赖 分 析 可 能 会 生成 有 误导 性 的 结果 , 而 这 些 结果 可 能 会 导致 有 问 
题 的 决策 。 同 时 ，OkHttp 的 版 本 也 并 不 国定 ， 而 是 完全 取决 于 Spring 使 用 的 版 本 。 如 果 更 新 了 
版 本 ， 那 么 项 目 中 依赖 于 OkHttp 的 代码 将 悄 无 声息 地 在 另 一 个 版 本 上 运行 ， 有 导致 程序 运行 时 
行为 异常 或 是 前 省 的 风险 。 

由 于 模块 系统 的 设计 只 允许 访问 具有 可 访问 性 的 模块 , 因此 这 一 风险 不 再 存在 。 只 有 在 项 目 
中 使 用 requires 关键 字 声 明了 对 OkHttp 模块 的 依赖 ,模块 系统 才 人 允许 访问 OkHttp 中 的 各 个 类 。 
这 种 方式 会 强制 人 们 让 配置 始终 保持 最 新 。 

请 注意 ， 模 块 能 够 通过 称 为 隐 式 可 读 性 ( implied readability ) 的 特性 将 自己 的 依赖 项 传递 给 
依赖 于 它们 的 模块 。 更 多 详情 参见 11.1 节 。 








没有 读 取 
外 无 法 访 
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3.3.3 封装 的 小 冲突 


正如 前 文 在 可 读 性 方面 所 做 的 那样 ， 让 我 们 搞 一 些 破 坏 ! 但 在 这 样 做 之 前 ， 先 要 展示 一 个 遵 
循 所 有 规则 的 正常 工作 场景 。 继 续 拿 第 2 章 中 介绍 的 ServiceMonitor 应 用 程序 举例 。 

为 了 更 好 地 举例 ， 假 设 模块 monitor.observer 的 monitor.observer 包 中 有 一 个 名 为 
DisconnectedServiceObserver 的 类 。 这 个 类 的 作用 无 关 紧 要 ， 重 要 的 是 它 实现 了 
Serviceobserver， 并 且 有 一 个 无 参数 的 构造 器 ， 同 时 模块 monitor 会 使 用 它 。 

模块 monitor.observer 导出 了 monitor.observer 包 , 并 且 DisconnectedServiceObserver 
是 公有 的 。 这 满足 了 可 访问 性 的 前 两 项 要 求 ， 所 以 其 他 模块 只 要 读 取 monitorobserver 模块 就 可 
以 访问 它 。 模 块 monitor 是 满足 这 些 条 件 的 ， 因 为 它 的 模块 声明 声明 了 对 模块 monitorobserver 的 
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依赖 ,综合 起 来 看 ( 如 图 3-10 和 代码 清单 3-1 所 示 ), 所 有 的 要 求 都 得 到 了 满足 , 因此 模块 monitor 
中 的 代码 不 仅 可 以 访问 DisconnectedqSserviceobserver， 而 且 能 够 顺利 编译 和 和 运行。 下文 将 
理 清 细 节 ， 并 观察 模块 系统 在 其 中 的 作用 。 

可 访问 性 的 所 有 有 要 求 都 请 其 足 


* monitor.c 


















V sr 是 公有 的 
V 2 包 是 已 导出 的 
本 monitor 读 取 monitor， Observer 





monitorobserver 





monitor 








DisconnectedServiceObserver ServiceObserver 


3-10 DisconnectedServiceObserver 是 公有 的 名， 所 在 的 monitor.observer 
包 是 已 导出 的 外。 模块 monitor 读 取 模块 monitor.observer 图 ， 所 以 模块 monitor 
中 的 代码 可 以 使 用 DisconnectedServiceObserver 


requires 
and reads 




















代码 清单 3-1 类 DisconnectedServiceObserver，monitor 可 访问 


// --- TYPE DisconnectedServiceObserver --- 
package monitor.observer; 
公有 的 monitor.observer.Disconnected- 
public class DisconnectedServiceObserver // P| 
implements ServiceObserver { 
// class body truncated 
} 


// --- MODULE DECLARATION monitor.observer ---— 
module monitor.observer { 
exports monitor.observer; // , Se 
) monitorobserver 模块 已 导出 
monitor.observer 包 
// --- MODULE DECLARATION monitor --- , ee EE 
module monitor { monitor 模 块 引用 并 且 最 终 读 
requires monitor.observer; // 取 monitor.observer 模块 


// other requires directives truncated 


1. 非 公 有 类 型 
如 果 DisconnectedServiceObserver 仅 是 包 内 可 见 的 , 则 会 导致 模块 monitor 编译 失败 。 
更 准确 地 说 ， 第 一 个 错误 是 导入 异常 。 
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> monitor/src/main/java/monitor/Monitor.java:4: error: 
> DisconnectedServiceObserver is not public in monitor.observer; 
> cannot be accessed from outside package 

> import monitor.observer.DisconnectedServiceObserver; 


入 














在 另 一 个 包 中 访问 仅 在 包 内 可 见 的 类 型 在 Java 9 之 前 也 是 不 可 以 的 , 所 以 上 述 错误 也 不 是 什 
么 新 鲜 事 一 一 即使 没有 模块 系统 也 会 得 到 相同 的 结果 。 
类 似 地 ， 如 果 在 DijsconnectedServiceObserver 设置 为 仅 包 内 可 见 后 ， 只 是 重新 编译 
monitor.observer 模块 ， 绕 过 编译 器 检查 ， 然 后 启动 整个 应 用 程序 ， 那 么 产生 的 错误 ( 如 下 所 示 ) 
和 没有 模块 系统 时 相同 。 


> Exception in thread "main" java.lang.IllegalAccessError: 
> failed to access class monitor.observer.DisconnectedServiceObserver 
> from class monitor.Monitor 










































































在 Java9 之 前 , 可 以 使 用 反射 API 在 运行 时 访问 该 (原本 不 可 访问 的 ) 类 型 , 这 是 新 的 强 封 
装 性 所 要 阻止 的 事情 。 考 虑 下 面 的 代码 。 


Constructor<?> constructor = Class 
.forName ("monitor.observer.DisconnectedServiceObserver") 
.getDeclaredConstructor(); 

constructor.setAccessible(true); 

ServiceObserver observer = (ServiceObserver) constructor.newInstance(); 


在 Java8 及 之 前 的 版 本 中 , 不 论 DisconnectedServiceObserver 是 公有 的 还 是 包 内 可 见 
的 ， 上 述 代 码 均 可 工作 。 在 Java 9 及 之 后 的 版 本 中 ， 如 果 DisconnectedServiceObserver 
是 包 内 可 见 的 ,模块 系统 则 会 阻止 其 访问 ,并且 在 调用 setAccessipble 方法 时 会 产生 如 下 异常 。 


> Exception in thread "main" java.lang.reflect.InaccessibleObjectException: 












































> Unable to make monitor.observer.DisconnectedServiceObserver() 
ps accessible: module monitor.observer does not "opens monitor.observer" 
> to module monitor 


代码 库 ServiceMonitor 中 的 break-reflection-over-internals 分 支 展 示 了 这 一 行为 。 
问题 的 关键 在 monitor.observer 中 一 一 12.2 节 将 深入 探索 解决 方案 。 


2. 未 导出 的 包 

列表 上 的 下 一 个 需求 是 必须 导出 包含 访问 类 型 的 包 。 为 了 达到 这 个 目标 , 再 次 将 Disconnected- 
ServiceObserver 公开 ,但 这 回 将 其 移动 到 男 一 个 没有 被 导出 的 包 monitor.observer.dis 
中 。monitor 中 的 导入 随 之 更 新 。 


monitor/src/main/java/monitor/Monitor.java:4: error: 
package monitor.observer.dis does not exist 
import monitor.observer.dis.DisconnectedServiceObserver; 


入 








(package monitor.observer.dis is declared in module 


a 
> 
> 
2 
加 
> monitor.observer, which does not export it) 
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这 里 的 错误 提示 非常 简单 明了 。 

如 要 查看 在 这 种 情况 下 运行 时 的 反应 ， 需 要 绕 过 编译 器 的 检查 。 为 此 ， 编 辑 monitor. 
observer 以 导出 monitor.observer.dqis， 编 译 所 有 模块 后 再 次 编译 monitor .observer， 
但 不 导出 该 包 。 尽 管 可 以 像 之 前 那样 启动 应 用 程序 ， 但 是 这 回 会 遇 到 运行 时 错误 。 






























































> Exception in thread "main" java.lang.IllegalAccessError: 

> class monitor.Monitor (in module monitor) cannot access class 
> monitor.observer.dis.DisconnectedServiceObserver (in module 
> 
~ 





monitor.observer) because module monitor.observer does not export 
monitor.observer.dis to module monitor 


与 编译 时 一 样 ， 运 行 时 的 错误 提示 也 很 简单 明了 ， 并 解释 了 问题 所 在 。 当 试图 用 反射 API 
将 构造 函数 更 改 为 可 访问 时 ， 结 果 也 是 如 此 。 为 此 可 以 创建 DisconnectedServiceObserver 
的 实例 。 


> Exception in thread "main" java.lang.reflect.InaccessibleObjectException: 
> Unable to make public 

> monitor.observer.dis.DisconnectedServiceObserver() accessible: 

a 














module monitor.observer does not "exports monitor.observer.dis" 
to module monitor 


仔细 观察 ， 就 会 发 现 运 行 时 和 反射 API 都 在 讨论 将 包 导 出 到 模块 ， 这 称 为 合 规 导出 (11.3 节 
将 进行 解释 )。 

3. 不 可 读 的 模块 

列表 中 的 最 后 一 个 要 求 是 ， 导 出 模块 必须 可 由 访问 该 类 型 的 模块 读 取 。 从 monitor 的 模块 声 
明 中 删除 requires monitor.observer 指令 会 导致 编译 错误 ， 这 符合 预期 。 





























monitor/src/main/java/monitor/Monitor.java:3: error: 
package monitor.observer is not visible 
import monitor.observer.DiagnosticDatapPoint; 


入 


(package monitor.observer is declared in module 
monitor.observer, but module monitor does not read it) 


如 要 想 查 看 运行 时 缺少 requires 指令 的 反应 ， 首 先 应 在 正确 的 配置 下 编译 整个 应 用 程序 ， 
即 monitor 会 读 取 monitor.observer 模 块 ;然后 从 monitor 的 module-info.java 文件 中 删除 requires 
指令 , 再 重新 编译 该 文件 。 这样， 编译 的 模块 代码 声明 需要 monitor.observer, 但 运行 时 将 看 到 一 
个 没有 声明 此 类 内 容 的 模块 描述 。 正 如 预期 的 那样 ， 运 行 时 错误 结果 如 下 。 


次 
2 
> 
> 
x 





















































> Exception in thread "main" java.lang.IllegalAccessError: 

> class monitor.Monitor (in module monitor) cannot access class 
> monitor.observer.DisconnectedServiceObserver (in module 

> monitor.observer) because module monitor does not read module 
> monitor.observer 





同样 ， 错 误 信 息 简 单 明 了 。 
最 后 ,尝试 一 下 反射 。 你 可 以 使 用 相同 的 编译 技巧 创建 不 读 取 monitor.observer 的 monitor 模 
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块 , 并 重用 之 前 在 DisconnectedServiceObserver 非 公有 的 情况 下 , 仍 要 通过 反射 创建 
时 的 代码 。 
当然 ， 运 行 这 些 模 块 也 必然 失败 ， 但 其 失败 方式 不 符合 预期 。 


> Exception in thread "main" java.lang.IllegalAccessError: 


由 
将 
全 





> class monitor.Monitor (in module monitor) cannot access class 
> monitor.observer.ServiceObserver (in module monitor.observer) 
> because module monitor does not read module monitor.observer 








为 什么 错误 消息 指向 serviceobserver? 因为 该 类 型 也 在 monitor.observer 中 ,但 monitor 
不 再 读 取 它 。 将 反射 代码 更 改 为 仅 使 用 object。 
Constructor<?> constructor = Class 
.forName ("monitor.observer.DisconnectedServiceObserver") 
.getDeclaredConstructor(); 


constructor.setAccessible(true); 
Object observer = constructor.newInstance(); 


运行 上 述 代 码 一 一 工作 正常 ! 但 缺少 的 读 取 边 呢 ? 答案 很 简单 ， 但 有 点 邻 人 惊讶 : 反射 API 
会 自动 引入 它们 ，12.3.1 节 将 深入 分 析 其 背后 的 原因 。 


3.4 ”模块 路 径 : 让 Java 了 解 模块 


现在 你 已 经 知道 如 何 定义 模块 及 其 基本 属性 ， 但 还 不 太 清楚 如 何 将 它们 告知 编译 器 和 运行 
时 。 第 4 章 将 深入 介绍 如 何 将 源码 构建 成 模块 化 的 JAR, 你 很 快 就 会 遇 到 正在 编译 的 代码 依赖 已 
有 模块 的 情况 。 第 5 章 的 情况 也 类 似 , 运行 时 需要 理解 应 用 程序 模块 , 以 便 你 启动 其 中 某 个 模块 。 

在 Java 9 之 前 ， 人 们 使 用 包含 普通 JAR 的 类 路 径 〈 可 以 参考 附录 A， 快 速 回顾 类 路 径 的 基 
础 知识 ) 来 告知 编译 器 和 运行 时 到 何 处 寻找 工件 。 在 编译 和 执行 时 ， 可 以 搜索 该 路 径 中 的 这 些 工 
件 ， 找 到 所 需 的 类 型 。 

然而 , 模块 系统 不 对 类 型 进行 操作 ， 而 是 管理 类 型 的 上 一 级 : 模块 。 这 种 方式 表达 了 一 个 全 
新 的 概念 : 模块 路 径 。 它 与 类 路 径 相似 ， 但 是 管理 模块 ， 而 非 普通 类 型 或 普通 JAR。 































































































定义 : 模块 路 径 

模块 路 径 是 一 个 列表 ， 其 元 素 是 工件 或 包含 工件 的 目录 。 根 据 操 作 系统 的 不 同 ， 模 块 路 径 
由 “:”( Unix 系统 ) 或 “;”( Windows 系统 ) 分 隔 。 模 块 系统 使 用 模块 路 径 来 查找 除 平台 模块 
之 外 的 所 需 模块 。javac、java 以 及 其 他 与 模块 相关 的 命令 都 可 以 处 理 模 块 路 径 ， 对 应 的 命 
令 行 选项 是 --module-path 和 -p。 


代码 清单 3-2 显示 了 如 何 编 译 、 打 包 和 启动 ServiceMonitor 应 用 程序 的 monitor 模块 。 它 的 
--module-path 命令 行 选项 指向 mods 目录 ， 其 中 假定 mods 目录 包含 所 有 依赖 的 模块 化 JAR。 
有 关 编 译 、 打 包 和 启动 的 详细 人 信息， 参见 4.2 节 、4.5 节 和 5.1 节 。 
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代码 清单 3-2 编译 、 打 包 和 启动 模块 


& javae 包含 直接 依赖 模块 
--module-path mods 的 目录 
-d monitor/target/classes i i 
ssoucc file 4 | 列 出 或 找到 所 有 源 文件 
$s Jar 一 -GEeate 2 
i mods/monitor.jar a mods 目录 中 新 创建 JAR 的 名 称 
--main-class monitor.Main 
-C monitor/target/classes . a 
a 包含 直接 依赖 和 传递 
--module-path mods:libs 依赖 的 目录 
--module monitor 


要 点 请 务必 认 清 只 有 模块 路 径 将 工件 作为 模块 进行 处 理 。 知 道 了 这 一 点 ,就 可 
以 更 准确 地 理解 什么 是 可 见 模块 全 集 了 。 在 3.1.4 节 中 ， 其 定义 如 下 : 当前 运行 
时 的 所 有 平台 模块 以 及 通过 命令 行 指定 的 所 有 应 用 程序 模块 都 叫 作 可 见 模 块 ， 它 
们 共同 构成 可 见 模块 全 集 。 








尽管 短语 “通过 命令 行 指定 的 模块 ”有 点 模糊 , 但 是 现在 你 只 需 知道 它 是 可 以 在 模块 路 径 上 
找到 的 工件 即 可 。 

请 注意 此 处 说 的 是 工件 而 不 是 模块 ! 当 放 置 在 模块 路 径 上 时 ， 不 仅 模 块 化 JAR 是 模块 ， 普 
通 JAR 也 会 被 视 为 模块 ， 成 为 可 见 模 块 全 集 的 一 部 分 。 这 种 令 人 惊讶 的 行为 是 模块 迁移 的 一 部 
分 ,在 这 里 详细 讨论 它 将 打 断 对 模块 路 径 的 探索 ， 因 此 对 该 部 分 的 介绍 将 推迟 到 8.3 节 。 现 在 需 
要 指出 的 是 , 与 模块 路 径 把 每 个 工件 视 为 模块 类 似 , 无 论 工件 是 否 包 含 模块 描述 符 , 类 路 径 都 把 
它们 全 部 当 作 普通 JAR 来 处 理 。 


















































注解 处 理 器 

如 果 正 在 使 用 注解 处 理 器 ， 那 么 你 很 可 能 将 它 与 应 用 程序 的 工件 一 同 放 在 了 类 路 径 上 。 
Java 9 建议 将 它们 加 以 区 分 : 应 用 程序 JAR 使用--class-path 或 --module-path; 处 理 器 
JAR 使 用 --processor-path 或 --processor-module-path。 对 未 模块 化 的 JAR， 应 用 程 
序 和 处 理 器 在 路 径 上 的 区 分 是 可 选 的 : 所 有 一 切 都 可 以 放 在 类 路 径 上 , 除了 它 绑 定 的 模块 ; 模 
块 路 径 上 的 处 理 器 不 能 使 用 。 





由 于 很 多 工具 (尤其 是 编译 器 和 虚拟 机 ) 会 使 用 模块 路 径 ， 因 此 有 必要 对 此 概念 进行 全 局 了 
解 。 除 非 男 有 说 明 ， 上 述 机 制 对 所 有 环境 都 有 效 。 


3.4.1 模块 解析 : 分 析 和 验证 应 用 程序 的 结构 
在 指定 模块 路 径 上 调用 javac 或 java 命令 后 ,会 发 生 什么 ? 首先， 模块 系统 开始 检查 启 
动 配置 ( 即 各 个 模块 及 其 声明 的 依赖 ) 是 否 可 靠 。 


要 开始 该 过 程 ， 必 须 有 根 模块 ， 因 此 模块 系统 此 时 的 第 一 要 务 是 定义 根 模块 集合 。 定 义 根 模 
块 有 多 种 方法 ， 本 书 将 在 适当 的 时 候 展 开 讨 论 ， 但 最 重要 的 是 指定 初始 模块 。 对 于 编译 名 而 言 ， 
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初始 模块 要 么 是 正在 编译 的 模块 ( 如 果 在 源 文件 中 )， 要么 是 使 用 --module 指定 的 模块 ( 如 果 
使 用 模块 源 代码 路 径 )。 在 启动 虚拟 机 的 情况 下 仅 有 --module 选项 可 用 。 

随后 , 模块 系统 开始 解析 依赖 关系 。 它 会 检查 根 模块 的 声明 ,查看 所 依赖 的 其 他 模块 ,并 尝 
试用 可 见 模块 满足 每 个 依赖 。 然 后 继续 对 这 些 模块 执行 相同 的 操作 ， 以 此 类 推 , 直到 满足 初始 模 
块 的 所 有 传递 依赖 ， 或 将 配置 标识 为 不 可 靠 。 
































解析 服务 和 可 选 依赖 
到 目前 为 止 模块 解析 的 如 下 两 个 方面 尚未 讨论 : 
口服 务 ( 参见 第 10 章 ,特别 是 10.2.2 前 ; 
口 可 选 依赖 (参见 11.2 节 ， 特别 是 11.2.3 欧 。 
由 于 缺少 必 备 知识 ,目前 本 书 不 会 对 它们 展开 讨论 。 提 及 它们 是 为 了 预告 后 文 将 出 现 的 知 
识 点 。 它 们 只 是 一 些 补 充 性 的 知识 片段 ， 不 会 有 悖 于 当前 描述 的 任何 内 容 。 





要 点 关于 不 可 靠 配置 , 3.2.2 节 已 经 探讨 了 在 此 阶段 中 可 能 出 错 的 情况 以 及 模块 
系统 的 反应 ,还 有 一 个 值得 注意 的 细节 需要 补充 : 如 果 模 块 路 径 包 含 多 个 条 目 ( 目 
录 或 单个 JAR )， 那 么 歧义 检查 不 会 应 用 在 这 些 条 目 上 ! 每 个 条 目 只 有 一 次 可 以 
包含 某 个 模块 ; 但 是 如 果 几 个 不 同 的 条 目 包含 同一 个 模块 ， 就 会 选择 第 一 个 条 目 
( 以 模块 路 径 上 的 命名 顺序 为 准 ) 它 尾 盖 了 其 他 模块 。 


下 面 展示 一 个 在 多 个 目录 下 存在 同名 模块 的 简单 例子 。 选择 一 个 准备 启动 旦 其 所 有 模块 都 位 
于 目录 (例如 mods ) 中 的 项 目 ， 然 后 创建 整个 目录 的 副本 ( 例如 mods-copy )， 并 将 两 者 放 在 模 
块 路 径 上 。 

S java 


--module-path mods :modqs-copy:1Libs 
--module monitor 


所 有 模块 在 每 个 目录 中 都 出 现 了 一 次 ,但 应 用 程序 还 能 正 

构建 工具 通常 会 创建 模块 路 径 并 分 别 列 出 每 个 依赖 ， 这 意 
例如 在 编译 和 测试 时 ， 歧 义 检查 就 不 会 应 用 于 所 有 依赖 。 

这 很 遗憾 ， 因 为 它 使 可 靠 配 置 的 部 分 承诺 变 得 毫 无 意义 。 然而, 它 也 有 好 的 一 面 ,你 可 以 故 
意 把 喜欢 的 版 本 放 在 第 一 位 ， 履 盖 同 名 模块 。 请 记 住 与 类 路 径 时 代 不 同 ， 不 同 的 JAR 永远 不 会 
“混合 ”"。 如 果 模 块 系统 选择 一 个 模块 作为 包 的 来 源 ， 那 么 它 将 从 该 JAR 中 查找 该 包 的 所 有 类 ， 
而 不 会 查看 任何 其 他 JAR (与 3.2.2 节 和 7.2 节 中 讨论 的 包 分 裂 相 关 )。 

接 下 来 , 假设 所 有 模块 都 已 解析 。 如 果 未 发 现 错误 , 模块 系统 就 会 保证 每 个 必需 模块 都 存在 ， 
或 者 更 确切 地 说 ,保证 每 个 必需 旦 具有 正确 名 称 的 模块 都 存在 。 

此 阶段 没有 额外 的 检查 ， 因 此 如 果 某 个 模块 依赖 于 com.google.common 模块 (谷歌 Guava 
库 的 模块 名 称 )， 模 块 系统 在 发 现 一 个 带 有 该 名 称 的 空 模块 时 则 不 会 报错 。 但 是 由 此 导致 的 模块 
缺失 问题 会 在 编译 时 或 运行 时 引发 报错 。 虽 然 一 般 不 太 可 能 出 现 空 模块 ,但 缺少 几 种 类 型 、 模 块 























常 局 动 。 
味 着 只 要 处 在 构建 工具 的 控制 下 ， 
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版 本 与 预期 不 符 的 情况 并 不 少见 。 尽 管 如 此 ， 可 靠 配置 将 大 大 降低 执行 期 间 突 然 出 现 
NoClassDefFoundError 的 频率 。 








3.4.2 ”模块 图 : 展示 应 用 程序 结构 


本 书 1.1.1 节 介 绍 了 如 何 用 图 将 软件 可 视 化 。 后 续 段 落 解释 了 开发 人 员 如 何 看 待 代码 以 及 某 
个 工具 如 何 处 理 代 码 ， 并 重点 介绍 了 工件 的 依赖 关系 图 。 第 1 章 的 其 余部 分 阐述 了 Java 将 工件 
视 为 类 型 的 容器 , 并 因此 陷入 “大 泥 球 ”问题 中 , 以 及 这 种 不 匹配 如 何 成 为 生态 系统 困扰 的 根源 。 

模块 系统 有 望 使 Java 的 感知 与 人 的 感知 保持 一 致 ， 从 而 解决 许多 问题 。 以 上 所 有 内 容 都 基 
于 一 个 事实 : 模块 系统 可 以 看 到 工件 图 。 这 就 引出 了 模块 图 。 





定义 : 模块 图 

在 模块 图 中 ， 模 块 ( 作为 节点 ) 根据 依赖 关系 ( 带 指向 的 边 ) 进行 连接 。 边 是 可 读 性 的 
基础 (3.2 节 对 此 进行 了 说 明 )。 该 图 在 模块 解析 期 间 构建 ， 并 可 在 运行 时 通过 反射 API 获得 
(12.4.2 节 对 此 进行 了 说 明 )。 








3-11 展示 了 如 何 为 简化 的 ServiceMonitor 应 用 程序 创建 模块 图 ,不 过 ,这 不 必 完 全 由 JPMS 
处 理 : 通过 使 用 正确 的 命令 行 选项 , 你 可 以 向 图 中 添加 更 多 模块 和 可 读 边 。 接 下 来 将 探讨 这 一 点 。 


monitor 正 在 被 解析 
| 2 
hibernate.jpa monitor hibernate.jpa 
> java.sql > java.sql 























monitor monitor 是 初 始 模块 因此 persistence statistics 
ee 它 就 是 模块 解析 的 起 始点 ”|| Beristence 

和 | 应 用 程序 模块 
S ee 及 其 依 炽 > a 


monitor 的 依赖 ，persistence 帮 Istatistics 


Be 被 添加 到 图 中 ， 但 尚未 解析 一 它们 将 
是 下 一 个 
CE 
3-11 模块 系统 为 简化 的 ServiceMonitor 应 用 程序 构建 模块 图 。 每 一 步 解析 一 个 模块 ， 
这 意味 着 该 模块 在 可 见 模块 全 集中 被 定位 ， 并 且 它 的 依赖 关系 被 添加 到 模块 图 


中 。 模 块 系统 一 步 一 步 地 解析 所 有 传递 依赖 关系 ， 在 某 个 时 间 点 ， 应 用 程序 模 
块 解析 完毕 ， 它 继续 解析 平台 模块 
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> persistence 
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CE 
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> java.xml 
Ee 2 
> hibernate.jpa 
raullos java.logging ~ :开始 解析 
> observer 见 在 开始 解析 
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图 3-11 
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所 有 模块 都 依 
java.base ， 这 不 
许多 模块 图 没有 人 列 
出 它 的 原因 
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3.4.3 ”向 图 中 添加 模块 


请 务必 注意 , 解析 过 程 中 未 被 放 入 模块 图 的 模块 在 编译 或 执行 期 间 将 不 可 用 。 当 所 有 应 用 程 
序 代码 都 在 模块 中 时 ,这 通常 无 关 紧要 。 遵循 可 读 性 和 可 访问 性 的 规则 ， 即 使 模块 可 用 但 由 于 没 
有 被 其 他 模块 引用 ， 其 类 型 也 无 法 访问 。 但 是 在 某 些 情况 下 , 使 用 高 级 功能 可 能 会 导致 编译 时 或 
运行 时 错误 ; 有 时 ， 应 用 程序 甚至 不 能 以 人 们 期 望 的 方式 工作 。 

导致 模块 不 在 模块 图 中 的 情形 有 很 多 , 反射 就 是 其 中 之 一 。 反射 可 以 用 来 调用 没有 明确 依赖 
关系 的 工件 代码 。 但 是 如 果 没 有 依赖 关系 ， 受 依赖 的 模块 就 可 能 无 法 进入 模块 图 。 

假设 存在 奉 代 statistics 的 monitor statistics.fancy 模块 ， 日 此 模块 不 在 每 一 个 部 署 的 模块 路 径 
上 【原因 无 关 紧 要 ， 可 能 是 为 了 防止 fancy 的 代码 被 “恶意 ”使 用 一 一 人 们 偶尔 就 是 想 这 样 做 )。 
该 模块 时 而 存在 时 而 不 存在 ， 导 致 其 他 模块 无 法 引用 它 ， 因 为 如 果 引 用 却 无 法 找到 模块 ,应 用 程 
序 将 无 法 启动 。 

应 用 程序 该 如 何 处 理 这 种 情况 ? 依赖 于 fancy 库 的 代码 可 以 使 用 反射 来 检查 类 库 是 否 存在 , 并 且 
仅 在 它 存 在 时 才 进 行 调用 。 但 根据 刚刚 介绍 的 内 容 ， 这 种 情况 永远 不 会 发 生 ! 由 于 没有 模块 依赖 ， 
因此 fancy 不 会 在 模块 图 中 , 这 意味 着 它 永 远 不 能 被 调用 。 针 对 这 些 问题 , 模块 系统 提供 了 解决 方案 。 












































































































































定义 : --add-modules 

java 和 javac 中 可 用 的 --add-modules ${modules} 选 项 采用 去 号 分 隔 模 块 名 称 列表 ， 
并 将 其 作为 初始 模块 以 外 的 根 模块 ( 如 3.4.1 节 所 述 ， 通 过 解析 根 模块 构成 的 初始 模块 集 及 其 
依赖 关系 构建 模块 图 )。 它 使 用 户 能 够 将 模块 (及 其 依赖 关系 ) 添加 到 模块 图 中 ， 而 不 至 于 由 
于 初始 模块 不 对 其 直接 或 间接 依赖 而 不 被 添加 到 模块 图 中 。 

--add-modules 选项 有 3 个 取 值 : ALL-DEFAULT、ALL-SYSTEM 和 ALL-MODULE-PATH。 
前 两 个 仅 在 运行 时 工作 ， 属 于 本 书 讨论 范围 外 的 边缘 案例 。 最 后 一 个 很 有 用 : 借助 它 ， 模 块 路 
径 上 的 所 有 模块 都 可 以 成 为 根 模 块 ， 因 此 所 有 模块 都 进入 了 模块 图 。 





























如 果 ServiceMonitor 应 用 程序 有 可 选 依赖 模块 monitor.statistics.fancy， 在 依赖 此 模块 进行 部 
署 时 ， 你 必须 确保 它 在 模块 图 中 。 这 种 情况 下 ， 用 --adqdq-moqules monitor.statistics . 
fancy 使 其 成 为 根 模块 ， 这 样 模块 系统 便 将 它 和 它 的 依赖 添加 到 了 模块 图 中 。 


$ java 
--module-path mods:libs 
--add-modules monitor.statistics.fancy 
--module monitor 


在 图 3-12 中 可 以 看 到 生成 的 模块 图 。 

--add-modules 特别 重要 的 一 个 用 例 是 JEE 模块 ， 如 6.1 节 所 述 ， 从 类 路 径 运 行 应 用 程序 
时 默认 不 会 解析 这 些 模 块 。 既 然 可 以 将 模块 添加 到 模块 图 中 ， 人 们 自然 联想 到 能 否 删除 它 们 。 等 
案 是 肯定 的 ， 即 使 用 --1imit-modules 选项 ，5.3.4 节 展 示 了 其 工作 原理 。 

遗憾 的 是 , 模块 系统 不 可 能 知道 你 其 实 并 不 在 意 一 些 依赖 不 能 被 找到 。 这 使 你 可 以 排除 不 需 
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要 的 (间接 ) 依赖 。 根 据 典 型 的 Maven POM 中 的 排除 次 数 ， 这 是 常见 现象 ， 但 模块 系统 不 允许 


这 人 么 做 。 
通过 反射 
访问 


Statistics 











statistics.fancy 





中 


v 
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更 多 依赖 
图 3-12 图 3-10 中 展示 了 简化 的 ServiceMonitor 应 用 程序 的 模块 图 以 及 通过 --add- modules 


定义 的 附加 根 模块 monitor.statistics.fancy。 由 于 monitor 及 其 依赖 模块 都 不 依赖 于 fancy 
模块 ， 因 此 如 果 不 使 用 此 选项 ， 它 就 不 会 被 添加 到 模块 图 中 














3.4.4 ”向 图 中 添加 边 





在 显 式 添加 模块 时 , 该 模块 在 模块 图 中 单独 显示 ,并 没有 任何 的 读 取 边 。 如 果 纯 粹 通过 反射 


访问 , 这 没什么 问题 , 因为 反射 API 隐 式 地 添加 了 读 取 边 。 但 是 如 果 为 了 引用 类 型 而 进行 常规 访 
问 ， 那 么 可 访问 性 规则 需要 可 读 性 。 








定义 : --add-reads 

编译 时 和 运行 时 选项 --add-reads ${module}=${targets} 会 添加 从 Ss{module} 到 
( 由 过 号 分 隔 的 ) 列表 ${targets} 中 所 有 模块 的 可 读 边 。 即 使 没有 requires 指令 提 及 它们 ， 
它 也 可 以 让 ${mogdule} 访 问 这 些 模 块 导 出 的 所 有 公有 类 型 。 如 果 ${targets} 包含 所 有 
ALL-UNNAMED， 那 么 ${module} 可 以 读 取 类 路 径 内 容 ( 参见 8.2 节 了 解 详细 信息 )。 





回 到 monitor statistics.fancy 的 例子 ,借助 aada-reads， 它 可 以 被 monitor.statistics 读 取 。 
S java 

--module-path mods:libs 

--add-modules monitor.statistics.fancy 


--add-reads monitor.statistics=monitor.statistics.fancy 
--module monitor 





这 种 方式 生成 的 模块 图 与 图 3-12 相同 ， 只 是 虚线 被 替换 为 适当 的 可 读 边 。8.3.2 节 末 尾 介绍 
的 例子 采用 --add-reads ... =ALL-UNNAMED 的 方式 实现 了 令 人 满意 的 效果 。 





3.4.5 ”访问 性 是 一 项 持续 的 工程 
一 旦 模块 系统 解决 了 所 有 依赖 关系 ,构建 了 模块 图 ， 建 立 了 模块 之 间 的 可 读 性 
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3.3 节 定 义 的 可 访问 性 规则 ， 从 而 保持 活动 状态 。 如 果 这 些 规 则 遭 到 破坏 ， 就 会 出 现 如 3.3.3 节 所 
述 的 编译 时 或 运行 时 错误 。 如 果 模 块 系统 出 了 问题 , 但 你 无 法 从 错误 消息 中 分 辩 问 题 在 哪儿 , 请 
参阅 5.3 节 ， 了 解 如 何在 这 种 情况 下 进行 调试 。 

如 果 你 有 兴趣 了 解 有 关 构 建 和 运行 模块 化 应 用 程序 ( 例如 自己 的 新 项 目 ) 的 更 多 信息 ， 可 以 
参考 第 4 章 和 第 $ 章 ， 这 两 章节 深入 探讨 了 这 一 点 。 你 也 可 以 在 第 6 章 和 第 7 章 中 查看 模块 系统 
对 现 有 项 目的 影响 。 如 果 准 备 深入 研究 模块 系统 的 高 级 功能 ， 请 参考 第 10 章 和 第 11 章 。 


要 点 “你 到 达 了 一 个 里 程 碑 ! 现在 你 已 经 了 解 了 如 何 定义 模块 、 模 块 定义 的 机 制 
以 及 相应 的 结果 。 总 而 言 之 ， 你 已 经 知道 Java 如 何 使 用 模块 了 。 








3.5 ”小结 


口 模块 的 两 种 形式 。 

得 Java 运行 时 自 带 的 平台 模块 。 它 们 被 合并 到 运行 时 libs 目录 的 modules 文件 中 。JDK 将 
它们 作为 JMOD 文件 保存 在 jmods 目录 中 。 模 块 系统 只 明确 地 知道 基础 模块 java.base。 

和 库 .框架 和 应 用 程序 开发 人 员 创建 了 模块 化 JAR , 庆 E JAR 是 包含 模块 描述 符 moqule- 
info.class 的 普通 JAR。 它们 被 称 为 应 用 程序 模块 , 其 中 包含 main 函数 的 模块 是 初 
始 模块 。 

口 模块 描述 符 是 编译 模块 声明 文件 module-info.java 得 到 的 。 开发 人 员 或 某 个 工具 可 以 
编辑 这 个 文件 。 它 位 于 模块 系统 的 核心 ， 定 义 了 模块 的 属性 。 
名 称 ， 采 用 反 向 域名 的 命名 方案 ， 并 具有 全 局 唯一 性 。 

和 依赖 ， 其 中 requires 指令 按 名 称 引 用 其 他 模块 。 
昌 API， 通 过 导出 exports 指令 指定 的 包 。 

口 依赖 声明 和 模块 系统 创建 的 可 读 性 边 是 可 靠 配置 的 基础 ， 它 确保 所 有 模块 只 存在 一 次 ， 

并 是 不 存在 循环 依赖 。 它 使 你 能 更 早 地 捕获 应 用 程序 异常 或 解决 月 演 问题 。 

口 可 读 性 边 和 导出 包 是 强 封装 的 基础 。 这 里 模块 系统 确保 只 有 导出 包 中 的 公有 类 型 才能 和 
访问 ， 且 只 能 被 可 读 的 模块 访问 。 它 可 以 防止 意外 地 依赖 于 传递 依赖 ， 并 确保 外 部 代码 
不 能 轻易 调用 模块 内 部 的 类 型 。 

口 访问 限制 也 适用 于 反射 ! 要 让 它 能 够 与 基于 反射 的 框架 ( 比如 Spring 、Guice 或 Hibernate ) 

交互 ， 需 要 做 一 些 额 外 的 工作 。 

模块 路 径 ( --module-path 或 -p 选项 ) 由 文件 或 目录 组 成 , 可 以 让 模块 系统 使 用 标示 为 模 
块 的 JAR。 不 使 用 类 路 径 是 为 了 让 编译 器 或 JVM 了 解 项 目的 工件 。 

模块 路 径 上 指定 的 应 用 程序 模块 和 运行 时 涵盖 的 平台 模块 构成 了 可 见 模块 全 集 。 由 于 模块 解 
析 期 间 搜 索 从 根 模块 开始 ， 因 此 所 有 必需 的 模块 都 必须 位 于 模块 路 径 上 或 运行 时 中 。 

模块 解析 会 验证 配置 是 否 可 靠 ( 如 3.2 节 所 述 , 是 否 所 有 依赖 都 存在 、 是 否 没有 歧义 ， 等 等 ) 
并 生成 模块 图 。 基 于 模块 图 ， 模 块 系统 可 以 与 你 看 待 工件 依赖 关系 的 视角 保持 一 致 。 在 运行 时 ， 
只 有 模块 图 中 的 模块 才 可 用 。 

























































































从 源码 到 JAR 构建 模块 








本 章 内 容 

口 项 目 目录 结构 

口 编译 单个 模块 
口 编译 多 个 模块 
口 打包 模块 化 JAR 





























第 3 章 中 描述 的 定义 模块 是 一 种 值得 掌握 的 技能 , 但 是 如 果 不 能 将 这 些 源 文件 转换 为 可 分 发 
和 可 执行 的 模块 化 工件 ( JAR )， 那 掌握 它 又 有 什么 意义 呢 ? 本 章 将 介绍 如 何 构建 模块 : 从 组 织 
源 代码 到 将 它们 编译 成 类 文件 , 最终 到 将 它们 打包 成 可 分 发 和 可 执行 的 模块 化 JAR。 第 5 章 将 重 
点 介绍 模块 化 应 用 程序 的 运行 和 调试 。 

有 时 人 们 会 使 用 命令 行 命 令 javac 和 jar。 对 此 你 可 能 会 有 疑问 一 一 IDE 和 其 他 工具 不 是 
会 调用 这 些 命令 吗 ? 可 能 是 的 , 但 除了 探索 工具 原理 这 一 论点 ， 了 解 这 些 命令 还 有 一 个 更 重要 的 
理由 : 它们 是 学 习 模 块 系统 核心 最 直接 的 途径 。 本 章 将 使 用 这 些 命令 探索 其 功能 。 学 完 本 章 后 你 
可 以 使 用 任何 工具 来 完成 这 些 功 能 。 

本 章 将 介绍 如 何在 磁盘 上 组 织 项 目的 文件 (参见 4.1 节 )。 这 似乎 不 太 重要 ,但 有 一 个 新 的 
建议 值得 研究 。 使 用 第 3 章 描 述 的 文件 布局 和 模块 声明 ， 人 们 将 能 够 编译 模块 ， 且 既 可 以 一 次 编 
译 一 个 模块 (参见 4.2 节 )， 也 可 以 同时 编译 多 个 模块 (参见 4.3 节 )。 最 后 一 节 讨 论 如 何 将 类 文 
件 打 包 进 模块 化 JAR。 请 参考 ServiceMonitor 的 master 分 支 ， 查 看 一 些 真实 的 构建 脚本 。 

本 章 结束 时 ， 你 将 能 够 组 织 、 编 译 和 打包 源码 以 及 模块 声明 。 由 此 生成 的 模块 化 JAR 可 以 
部 署 或 发 布 给 任何 使 用 Java 9 或 更 高 版 本 的 人 ， 使 他 们 充分 享受 模块 化 带 来 的 便利 。 


4.1 组 织 项 目的 目录 结构 


现实 中 的 项 目 由 大 量 不 同类 型 的 文件 组 成 。 显 然 ， 源 文件 是 最 重要 的 ， 但 是 它 只 是 其 中 的 
一 种 。 这 些 文件 还 有 测试 源 、 资 源 、 构 建 脚本 或 项 目 描述 、 文 档 、 源 代码 管理 信息 和 其 他 类 型 。 
任何 项 目 必 须 选 择 一 个 目录 结构 来 组 织 这 些 文件 ， 请 务必 确保 目录 结构 与 模块 系统 的 特征 互 不 
冲突 。 
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如 果 一 直 关 注 Jigsaw 项 目 开发 的 模块 系统 并 研究 了 快速 人 门 指南 或 早期 教程 ， 你 可 能 已 经 
注意 到 了 模块 系统 所 使 用 的 特定 目录 结构 。 请 看 一 下 官方 建议 , 评估 其 是 否 应 该 成 为 一 个 新 的 约 
定 , 并 将 其 与 Maven 和 Gradle 等 工具 的 默认 行为 对 比 ,然后 评估 官方 建议 是 否 能 够 与 它们 并 列 。 


4.1.1 新 提议 一 一 新 约定 


在 介绍 模块 系统 的 早期 出 版 物 中 ， 项 目 通常 包含 一 个 src 目录 ， 其 中 属于 项 目的 每 个 模块 都 
拥有 自己 的 子 目 录 ， 而 该 目录 包含 项 目的 源 文件 。 如 果 项 目 需要 的 不 仅仅 是 源 文件 , 那么 建议 将 
这 些 关 注 点 组 织 在 src 的 平 级 目录 ， 比 如 test 和 build 中 。 这 使 目录 具有 “关注 点 /模块 ”层次 结 
构 ， 如 图 4-1 所 示 。 






































ServiceMonitor 项 日 范 | 四 的 类 文件 日 孙 





Te 第 三 方 依赖 以 及 组 成 应 用 

MB mods 程序 的 模块 的 目录 

罚 src 
项 目 范围 的 源 代码 目录 上 图 monitor 

图 monitgriobsenver 《一 单个 模块 的 目录 ， 这 里 是 
国 monitor monitor.observer 

包 和 和 源 文件 的 公共 结构 ， " observer 
在 本 例 中 从 monitor 开 始 目 DiagnosticDataPoint.java 





目 ServiceObserver.java 
国 module-info.java 


) : module-info.java 位 于 
” 国 monitor.observeralpha java 位 了 


> 国 monitorob Ee 特定 模块 的 根 目录 中 
monitor.observer.beta 

” 国 monitor.persistence 

~ 国 monitorrest 

” 国 monitor.statistics 

test-src 二 
- 国 monitor 测试 和 其 他 文件 的 目录 

- 国 monitor.observer 存放 在 所 创建 的 与 src 

平 级 的 目录 中 ， 并 包含 


monitor.observer.alpha Ee 
每 个 模块 的 子 目 录 


~ 国 monitorobserver.beta 
” 国 monitor.persistence 





- 国 monitor.rest 
国 monitor.statistics 


图 4-1 此 结构 有 顶级 目录 classes 、mods 、src 和 test-src。 每 个 模块 的 源 代 码 位 于 src 
或 test-src 下 级 具有 模块 名 称 的 目录 中 


4.1.2 默认 的 目录 结构 


大 多 数 由 多 个 子 项 目 ( 现在 称 为 模块 ) 组 成 的 项 目 倾向 于 拥有 单独 的 根 目 录 。 每 个 根 目录 包 
含 单个 模块 的 sources 、test 和 resources 目录 以 及 前 面 提 到 的 其 他 目录 。 它 们 使 用 “模块 /关注 点 ” 


py 
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这 一 目录 层次 ， 这 是 已 知 的 默认 目录 结构 。 

默认 目录 结构 ( Maven 和 Gradle 等 工具 隐 性 地 理解 该 结构 ) 实现 了 该 层次 结构 ( 如 图 4-2 所 
示 )。 首先 ， 默 认 目 录 结 构 赋 予 了 每 个 模块 单独 的 目录 树 。 在 该 目录 树 中 ，src 目录 包含 生产 代码 
和 资源 (分别 在 main/java 和 main/resources 中 ，test 目录 包含 测试 代码 和 资源 (分别 在 test/java 
和 test/resources 中 。 














ServiceMonitor 
国 mods 每 个 模块 都 有 自己 的 
日 本 


国 monitor 结构 
国 monitorobserver 
国 src 
国 main i 
辐 java 


包 和 源 文件 的 公共 结构 ， 
国 monitor ee 在 本 例 中 从 monitor 开 始 
国 observer 
目 DiagnosticDataPoint.java 


src/main/java 子 目录 包含 源 代码 


module-info.java 


目 ServiceObserver.java ， 
立 于 特定 模块 的 根 
目 module-infojava i a 位 于 特定 模块 的 根 日 


加 
录 中 
国 resources 


国 test 
加 java test 目 录 树 与 main 相 同 
国 resources 
国 target 
国 monitor.observer.alpha 目标 目录 包含 编译 结果 ， 


最 终 包括 模块 JAR 
国 monitor.observer.beta 有 最 终 包括 司 


国 monitor.persistence 
加 monitor.rest 
国 monitor.statistics 


图 4-2 此 结构 中 每 个 模块 拥有 单独 的 顶级 目录 ， 然 后 模块 根据 自己 的 需求 可 以 自由 组 
组 文件 。 此 处 monitor.observer 使 用 Maven 和 Gradle 项目 中 的 通用 目录 结构 


构建 项 目 并 非 必 须 采 用 这 种 方式 。 这 样 做 会 带 来 两 部 分 额外 的 工作 : 为 分 散 的 目录 结构 添加 
额外 的 构建 工具 ; 处 理 多 模块 编译 的 情况 (参见 4.3 节 )。 如 果 抛 开 这 些 不 谈 ， 那么 所 有 目录 结 
构 一 样 有 效 ， 并 且 应 根据 项 目的 实际 情况 进行 考虑 。 

尽管 如 此 ， 本 书 的 示例 都 将 使 用 这 种 默认 结构 ， 唯 独 有 一 处 例外 : 如 果 所 有 模块 化 JAR 位 
于 同一 目录 中 ， 那 么 命令 行 较 为 简单 ， 因 此 ，ServiceMonitor 应 用 程序 拥有 包含 生成 的 模块 的 顶 
级 mods 目录 。 


4.1.3 ”模块 声明 的 位 置 


无 论 源 文件 目录 结构 如 何 , 模块 声明 文件 必须 命名 为 module-infojava。 和 否则， 编译 器 会 生成 
如 下 错误 ， 该 错误 源 于 尝试 编译 模块 声明 文件 monitor-observer-info.java。 
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> monitor.observer/src/main/java/monitor-observer-info.java:1: 
> error: module declarations should be in a file named module-info.java 
> module monitor.observer { 


入 


> 
> 1 error 


尽管 并 非 绝 对 必要 ,但 是 模块 声明 文件 一 般 应 该 位 于 源码 根 目录 中 ， 否 则 ，4.3.2 节 中 描述 
的 模块 源 代码 路 径 会 由 于 无 法 找到 描述 符 而 不 能 正常 工作 。 这 是 因为 模块 系统 无 法 找到 模块 描 
符 就 不 能 识别 模块 ， 进 而 导致 “ 找 不 到 模块 ”的 错误 。 

尝试 一 下 ， 将 monitor.observer 的 描述 符 文件 移 到 其 他 目录 并 编译 monitor。 如 下 所 示 ， 这 会 
导致 无 法 找到 monitorobserver ( monitor 所 需 ) 模块 的 错误 。 


谋 





~ 





党 





> ./monitor/src/main/java/module-info.java:2: 
> error: module not found: monitor.observer 
> requires monitor.observer; 
> 
~ 


入 


1 error 


4.2 编译 单个 模块 


一 旦 确定 了 项 目的 目录 结构 布局 , 那么 在 写 了 一 些 代 码 , 创建 了 模块 声明 后 ,就 可 以 编译 源 
文件 了 。 但 是 , 什么 是 编译 源 文件 ” 它 是 类 型 的 集合 或 亮 眼 的 模块 吗 ? 由 于 前 者 是 不 变 的 ， 因此 
在 探索 编译 器 如 何 识别 这 两 种 情况 之 前 ， 本 章 将 先 重 点 讨论 后 者 。 


4.2.1 编译 模块 代码 


本 节 将 重点 介绍 在 所 有 依赖 都 已 模块 化 的 情况 下 编译 单个 模块 的 方法 。 由 于 只 有 当 源 文件 中 
包含 模块 声明 module-info.java 文件 时 才能 编译 模块 ， 因 此 这 里 假设 这 种 情况 成 立 。 

除了 在 模块 路 径 上 检查 可 读 性 和 可 访问 性 ,编译 器 的 另 一 个 新 功能 是 处 理 模块 声明 。 编 译 模 
块 声明 的 结果 是 模块 描述 符 module-info.class 文件 。 与 其 他 .class 文件 一 样 ， 该 文件 包含 字 节 码 ， 
并 且 可 以 使 用 ASM 和 Apache 的 字 节 代码 工程 库 (BCEL ) 等 工具 进行 分 析 和 操作 。 

除了 使 用 模块 路 径 而 非 类 路 径 , 编译 的 工作 方式 与 Java 9 之 前 版 本 完全 相同 。 编译 器 将 编译 
所 有 给 定 的 文件 ， 并 在 -a 指定 的 输出 目录 中 生成 相应 的 目录 结构 。 

4-3 展示 了 monitor.observer 模块 (使 用 默认 目录 结构 ) 的 布局 ， 其 编译 方式 与 Java9 之 前 
版 本 类 似 ， 需 要 调用 javac 命令 。 
口 --module-path 选项 为 编译 需 指 示 包 含 所 需 应 用 程序 模块 的 目录 。 
口 -a 选项 指明 编译 的 目标 目录 ， 工 作 原 理 与 Java 9 之 前 版 本 相同 。 
口 列 出 或 找到 目录 monitor.observer/src/main/java/ 中 的 所 有 源 文件 ， 包 括 module-info.java 

(sfsource-files} 标 识 )。 

综合 起 来 ,在 ServiceMonitor 应 用 程序 的 根 目录 ( 即 包含 monitor.observer 的 目录 ) 中 运行 以 

下 命令 。 
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$ javac 
--module-path mods 
-d monitor.observer/target/classes 
$s{source-files} 


monitor.observer 
国 src 
国 main 


i 包 和 源 文件 的 公共 结构 
java 
国 monitor > 


国 observer 
目 DiagnosticDataPoint.java 
目 ServiceObserver.java 
目 moduleinfojava 《一 一 一 一 模块 根源 代码 目录 中 的 
国 resources 模块 声明 
ea 《一 一 一 包含 编译 结果 的 target 目 录 


图 4-3 monitorobserver 模块 的 目录 结构 ， 并 展开 了 src 目录 
折 和 县 src 目录 并 展开 target/classes ， 预 期 结果 如 图 4-4 所 示 。 








monitor.observer 包含 模块 源 代码 的 目录 
国 src 
国 target 
加 classes 包 和 类 文件 的 结构 
国 monitor a 
国 observer 


目 DiagnosticDataPoint.class 
目 ServiceObserver.class 


目 module-info.class< 一 一 一 模块 描述 符 
图 4-4 monitor.observer 模块 的 目录 结构 ， 并 展开 了 target 目录 




















4.2.2 ”模块 或 非 模块 


Java 平 台 模块 系统 的 最 终 目 的 是 创建 并 运行 模块 , 但 这 并 不 是 强制 性 的 , 人 们 仍然 可 以 构建 
普通 的 JAR, 这 就 带 来 了 区 分 这 两 种 情况 的 问题 。 编 译 器 如 何 知道 要 创建 的 是 一 个 模块 还 是 一 堆 









































类 型 ? 


要 点 ”正如 3.1.2 节 提 到 的 , 模块 化 JAR 只 是 一 个 带 有 模块 描述 符 module-info.class 
文件 的 普通 JAR， 而 该 描述 符 由 模块 声明 module-info.java 文 件 编译 得 到 。 因 此 ， 
编译 器 根据 源 代码 列表 中 是 否 存 在 module-info.java 文件 来 判断 是 否 以 模块 的 方 
式 进 行 处 理 。 这 就 是 没有 编译 器 --create-module 选项 或 类 似 选 项 的 原因 。 











编译 模块 和 只 编译 类 型 有 什么 区 别 呢 ? 正如 3.2 节 所 解释 的 那样 ， 它 的 可 读 性 下 降 了 。 如 果 
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编译 包含 模块 声明 的 代码 ， 那 么 : 
口 必须 要 求 依 赖 可 以 访问 这 些 依赖 导出 的 类 型 ; 
口 所 引用 的 依赖 必须 存在 。 
另 一 方面 ,如果 编译 非 模块 化 代码 , 那么 由 于 没有 模块 声明 ,不 会 有 任何 依赖 得 到 表达 。 这 
种 情况 下 ， 模 块 系统 会 让 被 编译 的 代码 读 取 所 有 模块 以 及 它 在 类 路 径 中 找到 的 任何 工件 。8.2 节 
将 探讨 类 路 径 模式 的 细节 。 
与 可 读 性 相反 ,3.3 节 描 述 的 可 访问 性 规则 对 两 种 情况 都 有 效 。 无 论 代 码 是 作为 模块 编译 的 ， 
还 是 作为 一 组 源 代码 编译 的 ， 当 访问 其 他 模块 的 类 型 时 ， 它 们 都 遵循 这 些 规则 。 这 与 JDK 内 部 
类 (都 是 非 导 出 包 中 的 公有 类 或 非 公 有 类 ) 尤为 相关 ， 因 为 无 论 怎样 编译 代码 ,它们 都 是 不 可 访 Ge 
问 的 。 图 4-5 展示 了 可 读 性 和 可 访问 性 的 区 别 。 
可 读 性 区 别 ;: 
非 模块 化 代码 可 以 读 


模块 化 代码 仅 可 以 
读 取 其 依赖 的 模块 。 “一 >》 














a 












































访问 性 行为 一 致 : 





不 论 是 模块 化 代码 还 是 非 
模块 化 代码 ， 都 只 能 使 
可 访问 的 类 型 ( 即 导出 包 
中 的 公有 类 型 ) 


图 4-5 对 比 非 模块 化 代码 〈 左 ) 与 模块 化 代码 ( 右 ) 的 编译 。 可 读 性 规则 稍 有 区 别 ， 
而 可 访问 性 规则 完全 一 至 


























编译 错误 

以 ServiceMonitor 应 用 程序 为 例 。 它 的 子 项 目 monitor 包含 源 文 件 Main.java、Monitor.java 
和 module-info.java。 

如 果 在 这 些 文件 中 加 入 模块 声明 ，javac 就 准备 将 其 编译 为 模块 ， 并 验证 所 有 应 用 程序 
和 平台 模块 的 依赖 是 否 都 声明 在 描述 符 中 。 如 果 没 有 模块 声明 , 编译 器 则 会 回 退 到 仅 能 识别 类 
型 间 的 依赖 ， 如 图 3-1 所 示 。 

但 是 不 论 monitor 是 否 被 编译 为 模块 , 只 要 它 使 用 了 JDK 模块 或 其 他 应 用 程序 模块 无 法 访 
问 的 类 型 ， 结 果 都 是 一 样 的 : 编译 错误 。 





编译 模块 显然 比 仅 编译 类 型 需要 清理 更 多 的 障 但 , 那 为 什么 还 要 这 么 做 呢 ? 再 次 与 用 静态 类 
型 语言 编写 代码 对 比 。Java 开发 考 通 常 相信 , 静态 类 型 的 好 处 相 较 于 它 带 来 的 额外 成 本 是 值得 的 ， 
因为 作为 交换 ,他 们 得 到 了 快速 且 可 靠 的 一 致 性 检查 。 这 种 检查 虽然 不 能 避免 所 有 错误 ,但 确实 
避免 了 很 多 错误 。 
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同样 ， 通 过 模块 系统 编译 模块 相 比 创建 普通 JAR 需要 付出 更 多 ， 但 是 作为 交换 ， 人 们 可 以 
借助 检查 减少 运行 时 错误 。 人 们 用 编译 时 的 额外 付出 来 换取 运行 时 的 安全 ,而 这 是 一 种 在 任何 时 
修 都 “ 稳 赚 的 买卖 ”。 


4.3 编译 多 个 模块 


按照 上 面 描述 的 方式 编译 单个 模块 非常 简单 ， 而 编译 所 有 7 个 ServiceMonitor 模块 基本 上 是 
一 样 的 。 但 是 , 是 否 有 必要 逐个 编译 这 些 模块 ? 或 者 换 一 个 角度 ,， 有 什么 理由 不 这 样 做 吗 ? 后 者 
的 答案 是 肯定 的 ， 有 一 些 细节 使 一 次 性 编译 多 个 模块 更 加 合适 。 
口 付出 一 一 虽然 编译 单个 模块 非常 简单 ， 但 是 将 多 个 模块 逐个 编译 所 需 的 工作 量 会 迅速 增 
加 。 而 且 , 一 遍 又 一 遍地 重复 几乎 相同 的 命令 (它们 之 间 仅 有 微小 的 区 别 ), 会 让 人 非常 
厌烦 。 虽 然 除非 正在 试用 Java9, 否则 你 很 少 会 手动 完成 这 些 操 作 , 但 是 工具 开发 者 的 感 
受 也 应 纳入 考虑 。 
口 性 能 一 一 在 我 的 系统 中 ， 编 译 单个 模块 描述 符 消耗 大 约 0.5 秒 ， 而 编译 ServiceMonitor 应 
用 程序 的 所 有 模块 消耗 大 约 4 秒 。 如 果 考 虑 到 总 共 只 有 不 到 20 个 源 文件 ， 这 样 的 耗 时 就 
有 点 长 了 ,而 且 编 译 规模 更 大 的 项 目 通 常 并 不 需要 这 么 长 时 间 。 主 要 原因 在 于 , 7 次 启动 
编译 需 〈 因 为 有 7 个 模块 ) 花费 了 不 少时 间 。 
口 弱 循环 依赖 一 一 虽然 模块 系统 禁止 通过 requires 指令 产生 循环 依赖 ， 但 是 还 有 其 他 方 
法 可 以 让 模块 相互 依赖 (请 相信 我 ) 虽然 这 样 的 依赖 是 循环 的 , 但 是 可 以 被 认 作 弱 循环 ， 
因为 如 果 找 不 到 正确 的 依赖 ， 你 就 只 会 得 到 一 个 警告 。 当 然 ， 实 现 无 警告 的 编译 需要 
些 付出 ， 而 且 两 个 模块 需要 同时 编译 。 































































































































































































要 点 “导致 需要 同时 编译 多 个 模块 的 原因 有 很 多 ， 编 译 器 能 够 做 到 这 一 点 是 件 
好 事 ! 





4.3.1 直接 编译 
如 何 一 次 性 编译 多 个 模块 ”能 将 多 个 模块 的 源 文件 列 出 并 让 编译 器 处 理 吗 ? 不 能 。 


S javac 
--module-path mods:libs 
-d classes 
monitor/src/main/java/module-info.java 
monitor.rest/src/main/java/module-info.java 





> monitor.rest/src/main/java/module-info.java:1: 


二 error: too many module declarations found 
> module monitor.rest { 
se 


> 1 error 


很 明显 ， 编 译 需 倾向 于 一 次 只 处 理 一 个 模块 。 这 也 很 正常 ,正如 之 前 讨论 的 ， 它 基于 定义 清 





4.3 ”编译 多 个 模块 83 





晰 的 模块 边界 强制 性 地 实现 了 可 读 性 和 可 访问 性 ,这么 多 来 自 不 同 模块 的 源 文件 混合 在 一 起 进行 
编译 ， 要 如 何 确定 模块 边界 ? 编译 器 需要 知道 一 个 模块 在 哪里 结束 ， 下 一 个 模块 在 哪里 开始 。 


4.3.2 ”模块 源 代 码 路 径 : 将 项 目 结构 告知 编译 器 


要 打破 默认 的 单个 模块 模式 ， 可 以 借助 命令 行 选项 来 告知 编译 器 项 目的 目录 结构 。 同 时 , 编 
译 器 也 支持 多 模块 编译 ， 可 以 一 次 性 构建 多 个 模块 。 使 用 命令 行 选 项 - -module-source-path 
$ {path} 可 以 打开 这 个 模式 ， 并 且 指 出 包含 模块 的 目录 结构 。 编 译 絮 的 其 他 选项 则 没有 变化 。 
这 听 上 去 很 容易 ， 但 是 仍 有 一 些 重要 的 细节 需要 考虑 。 在 此 之 前 ， 先 看 一 个 简单 的 例子 。 
假设 在 某 个 时 刻 ，ServiceMonitor 应 用 程序 使 用 4.1.1 节 定 义 的 单一 src 目录 结构 ， 而 所 有 的 
模块 源 代 码 目录 都 在 src 目录 下 面 (如 图 4-6 所 示 )。 可 以 使 用 --moqule-source-path src 将 
编译 器 指向 src 目录 (该 处 包含 所 有 模块 的 源 代码 )， 并 告诉 编译 器 立即 编译 已 找到 的 所 有 内 容 。 
ServiceMonitor 
> 国 classes 
> 国 mods 
vsrc 
> 国 monitor 
> 国 monitorobserver 
六 国 monitorobserveralpha 
> 国 monitor.observer.beta 
> 国 monitor persistence 
P 国 monitorrest 
上 国 monitor statistics 
4-6 如 果 项 目 只 有 一 个 src 目录 ， 每 个 模块 源 代码 的 根 目录 都 在 src 目录 之 下 , 那 
么 使 用 模块 源 代码 路 径 的 方式 是 最 容易 的 


在 构建 单个 模块 时 , 模块 路 径 用 于 告诉 编译 器 包含 所 需 应 用 程序 模块 的 目录 在 哪里 。 在 这 种 
情况 下 , 它们 都 是 外 部 依赖 ,因为 ServiceMonitor 的 所 有 模块 都 正在 被 编译 。-a 选项 的 工作 方式 
与 构建 单个 模块 时 相同 ， 你 仍然 可 以 列 出 src 目录 下 的 所 有 源 代码 文件 ， 包 括 所 有 的 模块 声明 。 

放 在 一 起 ,命令 如 下 。 

$ javac 

--module-path mods:libs 
--module-source-path src 


-d classes 
Ss{source-files} 


classes 选项 会 展示 一 个 按照 模块 划分 的 目录 结构 ， 每 个 目录 包含 了 模块 的 类 文件 以 及 模 
块 描述 符 ， 非 常 整洁 。 

但 事情 并 不 总 是 那么 容易 。 如 果 项 目 没有 使 用 单一 src 目录 结构 ， 该 如 何 处 理 ” 这 时 要 引入 
模块 源 代码 路 径 的 一 个 细节 。 
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4.3.3 星 号 作为 模块 名 称 的 标记 


模块 源 代码 路 径 可 以 包含 一 个 星 号 ( * )。 虽然 它 通 常 被 解释 为 通配符 ( 在 路 径 中 通配符 通常 
表示 “目录 中 的 任何 内 容 ” )， 但 在 此 处 并 不 是 这 样 。 相 反 ， 星 号 作为 标记 ， 指 示 模 块 名 称 出 现在 
路 径 的 哪个 位 置 。 星 号 后 面 的 其 余 路 径 必 须 指向 包含 模块 包 的 目录 。 

这 样 ， 编 译 器 就 可 以 将 源 文件 路 径 对 应 到 模块 源 路 径 ， 并 推断 出 源 文件 属于 哪个 模块 。 要 实 
现 这 一 点 ， 每 一 个 源 文 件 都 必须 对 应 到 模块 源 路 径 。 

这 看 上 去 有 些 复杂 ， 让 我 们 用 一 个 例子 解释 清楚 。 回 到 4.1.2 节 介 绍 的 ServiceMonitor 应 用 
程序 。 该 应 用 程序 中 的 每 个 模块 都 用 src/main/java 目录 来 存放 源 文件 。 下 面 展 示 了 一 些 源 文件 相 
对 于 项 目 顶级 目录 的 路 径 。 


口 monitor/src/main/jJava/monitor/Monitor.java 
















































































口 monitor/src/main/Java/monitor/Main.java 

口 monitor/src/main/java/module-info.java 

口 monitorrest/Src/main/java/monitorresVMonitorServer.java 
口 monitor.rest/src/main/Java/module-info.java 


口 monitor.persistence/src/main/java/monitor/persistence/StatisticsRepository.java 





口 monitor.persistence/src/main/java/module-info.java 

它们 有 明显 的 共同 结构 一 一 所 有 的 路 径 都 遵循 $ {modules}/src/main/java/$ {packages}/$ {sources} 
模式 。 

回顾 一 下 模块 源 路 径 的 使 用 方法 ， 就 能 发 现 $ tmodqules} 必 须 被 奉 换 为 “*”， 并 且 你 必须 忽 
略 包 目 录 ， 只 留 下 */srcmain/java。 但 是 ， 它 还 不 能 正常 工作 ， 因 为 编译 器 不 接受 星 号 作为 第 
个 字符 一 一 你 必须 在 前 面 加 上 “./”。 现 在 ， 多 模块 编译 就 可 以 工作 了 ， 这 简直 像 魔法 一 样 神奇 。 


$ javac 
--module-path mods:libs 
--module-source-path "./*/src/main/java" 
-d classes 
Ss{source-files} 


与 前 面 一 样 ， 所 有 类 文件 都 被 编译 至 相关 模块 的 classes 子 目 录 。 在 了 解 了 要 用 星 号 作为 模 
块 名 标记 后 ， 你 可 以 将 这 些 路 径 概括 为 -d classes/*。 但 是 很 遗憾 ，-a 选项 并 不 认识 模块 名 标记 ， 
此 你 无 法 用 它 来 构建 ./*/target/classes 这 样 的 输出 路 径 。 

你 也 许 会 好 奇 ， 第 一 个 例子 中 星 号 与 --module-source-path src 是 如 何 关联 的 。 毕 竟 你 
没有 指定 模块 名 出 现 的 位 置 ,编译 器 却 能 够 推断 出 它们 。 虽 然 让 人 直观 上 感觉 比较 奇怪 , 但 这 是 
为 了 让 简单 的 用 例 更 易于 使 用 。 

如 果 模 块 源 路 径 不 包含 星 号 , 那么 编译 器 会 默认 将 其 添加 为 最 后 一 个 路 径 元 素 。 因 此 ,你 已 
经 有 效 地 将 sre/* 指 定 为 模块 源 路 径 ， 这 与 例子 中 的 目录 结构 相同 。 

当 所 有 模块 都 使 用 相同 的 目录 结构 时 , 你 可 以 一 次 性 编译 多 个 模块 , 这 足以 覆盖 大 多 数 情 况 。 
而 要 处 理 更 复杂 的 情况 ， 你 需要 另 一 项 技术 。 
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4.3.4 多 模块 源 路 径 入 口 


有 时 , 单一 的 模块 源 路 径 可 能 无 法 满足 需求 : 不 同 的 模块 可 能 使 用 不 同 的 目录 结构 , 或 者 一 
些 模 块 的 源 文 件 分 布 在 多 个 目录 中 。 这 种 情况 下 ,可 以 指定 几 个 模块 源 路 径 条 目 ， 以 确保 每 个 源 
文件 都 匹配 一 个 路 径 。 

作为 一 个 复杂 的 项 目 ，JDK 拥有 庞大 的 目录 结构 。 图 4-7 仅仅 展示 了 它 的 冰山 一 隅 一 一 实际 
上 ， 在 每 个 层级 中 会 有 更 多 的 目录 。 








JDK 
国 src 


a 国 java.base 
国 java.desktop 在 所 有 操作 系统 
国 share 中 共享 的 代码 
国 classes 


一 一 ”加 java 一 些 代码 与 操作 系统 相关 ， 


这 些 是 单独 
的 模块 















is 存放 于 恰当 命名 的 目录 中 
国 classes 
3 国 java 
国 windows 
国 java.logging 


图 4-7 JDK 源 代码 目录 的 部 分 视图 。 注 意 src 下 面 的 模块 目录 是 如 何 进 一 步 划 分 的 。 
首先 是 classes 目录 ， 之 后 是 真正 的 源 文件 根 目录 


假设 你 想 在 jdk 目录 中 针对 UNIX 进行 构建 ， 那 么 一 个 跨越 所 有 模块 和 正确 的 源 目 录 的 模块 
源 路 径 是 什么 样 的 呢 ? 到 UNIX 源 代码 的 路 径 是 srcjava.desktop/unix/classes ， 或 者 更 一 般 地 ， 是 
src/$ {module}/unix/classes。 同 样 ， 到 共享 源 代 码 的 路 径 是 sre/$ {module}/share/classes。 将 这 两 者 
放 在 一 起 ， 你 将 得 到 如 下 路 径 : --module-source-path "src/*/unix/classes":"src/*/share/classes"。 

为 了 减少 元 余 ， 模 块 源 路 径 允 许 你 通过 {qirl, dir2} 来 定义 蔡 代 路 径 。 如 果 它 们 仅 在 某 一 
路 径 元 素 上 有 区 别 ， 则 可 以 将 这 些 模块 源 路 径 合 并 。 使 用 替代 路 径 ， 可 以 将 到 share 和 unix 
源 的 路 径 合 并 为 如 下 路 径 : --module-source-path "src/*/{share,unix}/classes"。 














4.3.5 设置 初始 模块 


在 为 多 模块 编译 做 好 充分 准备 后 ,又 出 现 了 另 一 种 可 能 性 : 仅 通过 名 称 来 指定 编译 单个 模块 
和 其 依赖 。 为 什么 要 这 么 做 ? 因为 它 不 再 要 求 你 明确 地 列 出 要 编译 的 源 文件 ! 

如 果 设 置 了 模块 源 路 径 , 那么 --mogdule 选项 可 以 让 你 在 没有 明确 列 出 源 文件 的 情况 下 ， 编 
译 单个 模块 以 及 它 的 传递 依赖 。 模 块 源 路 径 用 来 确定 属于 指定 模块 的 源 文件 , 并 根据 其 声明 解析 
依赖 关系 。 

这 使 得 编译 monitorrest 及 其 依赖 变 得 更 加 简单 。 和 前 面 一 样 ， 可 以 通过 --module-path 
mods :1ibs 指定 在 哪里 寻找 依赖 ,通过 -qd classes 定义 输出 目录 , 通过 --module-source-path 
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"./x*Vstrc/main/java" 为 编译 器 指定 项 目的 目录 结构 , 通过 --module monitor.rest 指定 从 
monitorrest 开始 编译 。 


$ javac 
--module-path mods:libs 
--module-source-path "./*/src/main/java" 
-d classes 
--module monitor.rest 




















如 果 在 编译 前 classes 是 空 的 ， 那 么 现在 它 包 含 monitorrest (指定 的 模块 )、monitorstatistics 
直接 依赖 ) 以 及 monitorobserver (传递 依赖 ) 的 类 文件 。 

之 前 , 代码 清单 2-3、 代 码 清单 2-4 和 代码 清单 2-5 展示 了 分 步 编译 ServiceMonitor 应 用 程序 
的 步骤 。 在 掌握 了 多 模块 编译 的 使 用 方法 后 ， 它 可 以 像 下 面 这 样 简单 地 完成 。 


$ javac 
--module-path mods:libs 
--module-source-path "./*/src/main/java" 
-d classes 
--module monitor 


因为 初始 模块 monitor 依赖 于 所 有 其 他 模块 ， 所 以 所 有 模块 都 得 到 了 构建 。 与 分 步 编译 的 方 
式 不 同 ， 类 文件 被 存放 在 classes/*( 使 用 “*” 作 为 模块 名 标记 ) 而 非 */target/classes 之 中 。 
除了 使 命令 更 容易 阅读 之 外 ，--module-source-path 和 --module 的 组 合 还 可 以 在 更 高 
的 抽象 级 别 上 进行 操作 。 与 列 出 单个 源 文 件 相 反 , 它 清楚 地 说 明了 编译 特定 模块 的 意图 。 我 很 喜 
欢 这 样 。 
不 过 这 种 方式 也 有 两 个 缺点 。 
口 编译 后 的 类 文件 不 能 重新 分 布 于 各 自 的 子 目 录 中 ， 而 是 集中 在 同一 个 目录 下 〈classes 是 
最 直接 的 例子 )。 如 果 在 构建 过 程 结束 之 后 需要 依赖 于 这 些 文件 的 准确 位 置 ， 那 么 就 必须 
采取 额外 的 准备 步骤， 这 可 能 会 抵消 使 用 模块 源 路 径 带 来 的 优势 。 
口 如 果 使 用 - -moaule 进行 编译 ( 而 不 是 列 出 所 有 模块 的 源 文件 )， 那 么 编译 器 的 一 些 优化 
处 理 可 能 会 导致 意外 的 结果 ， 其 中 之 一 是 进行 未 使 用 代码 检测 。 初 始 模块 未 间接 引用 的 
类 将 得 不 到 编译 ;如 果 模 块 进行 服务 解 耦 (参见 第 10 章 )， 甚 至 整个 模块 都 可 能 从 输出 
由 丢失 
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4.3.6 值得 吗 
多 模块 编译 值得 使 用 吗 ? 前文 曾经 列 出 3 个 原因 鼓励 你 使 用 它 , 所 以 很 自然 地 ,下 面 回顾 一 








下 这 些 原因 。 
口 付出 一 一 一 旦 掌握 了 构造 模块 源 路 径 的 方法 ， 编 译 多 个 模块 的 工作 量 就 会 大 大 减少 。 显 














然 ， 构 建 特定 的 模块 及 其 依赖 也 将 变 得 更 加 容易 。 与 此 同时 ， 构 建 工具 通常 是 逐个 编译 
项 目的 ， 如 果 要 求 同 时 编译 所 有 项 目 可 能 会 增加 复杂 性 ， 特 别 是 必须 进一步 将 类 文件 分 
发 到 特定 于 模块 的 目录 中 时 。 
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口 性 能 











使 用 多 模块 编译 ，ServiceMonitor 应 用 程序 在 不 到 1 秒 的 时 间 内 构建 完毕 ， 比 分 

















步 构建 7 个 模块 快 4 倍 。 但 这 是 一 种 非常 极端 的 情况 ， 因 为 本 例 中 每 个 模块 只 包含 2 到 3 

个 类 。 相 对 于 此 ， 启 动 编译 器 7 次 的 确 会 有 很 多 开销 ; 但 从 绝对 时 间 上 说 ， 这 样 至 多 耗 

3 秒 钟 。 对 于 任何 一 般 规模 的 项 目 而 言 ， 为 了 节省 区 区 几 秒 钟 的 构建 时 间 而 增加 项 目 
的 复杂 性 ， 基 本 是 不 值得 的 。 

口 弱 循环 依赖 一 一 在 这 种 情况 下 ， 多 模块 编译 无 法 满足 无 警告 构建 的 要 求 。 


时 


总 而 言 之 ， 多 模块 编 
是 如 果 你 的 工具 不 能 无 名 地 支持 它 , 那么 使 用 它 可 能 不 值得 。 这 是 一 个 典型 的 “需要 看 实际 情况 ” 





































































































是 一 种 可 选项 ， 而 且 它 带 来 的 好 处 不 足以 支撑 其 作为 默认 选项 。 尤 其 












































的 场景 。 尽 管 如 此 ， 我 仍然 喜欢 在 更 高 级 别 的 抽象 ， 即 模块 而 不 仅仅 是 类 型 上 ， 使 用 它 。 


4.4 编 


译 器 选项 





随 着 模块 系统 产生 了 一 系列 新 的 命令 行 选项 , 本 书 将 对 它们 进行 介绍 。 为 了 帮 你 轻松 地 找到 
它们 ， 表 4-1 列 出 了 与 编译 器 相关 的 所 有 选项 。 










































































表 4-1 按 字母 顺序 排列 的 所 有 与 模块 相关 的 编译 器 〈javac 命令 ) 选项 。 以 下 描述 列 基 于 官方 
文档 ， 引 用 指向 本 书 中 进行 详细 介绍 的 章节 

选 项 描述 引 用 
--add-exports 使 模块 导出 额外 的 包 11.3.4 节 
--add-modules 定义 除 初始 模块 外 的 其 他 根 模块 3.4.3 节 
--add-reads 在 模块 间 添 加 可 读 边 3.4.4 节 
--limit-modules 限定 可 见 模块 全 集 5.3.5 节 
--module、-m 设 定 初始 模块 4.3.5 节 
--module-path、-p 指定 查找 应 用 程序 模块 的 位 置 3.4 节 
--module-source-path 告知 编译 器 项 目的 目录 结构 4.3.2 节 
--module-version 指定 编译 器 使 用 的 模块 版 本 13.2.1 节 
--patch-module 在 编译 过 程 中 用 类 扩展 已 有 模块 7.2.4 节 
--processor-module-path 指定 查找 注解 处 理 器 模块 的 位 置 4.2.1 节 
--system 重新 指定 系统 模块 的 位 置 6.4.4 节 
--upgrade-module-path 定义 可 升级 模块 的 位 置 6.1.3 节 


新 的 选项 : --release 

你 是 否 曾 使 用 -source 和 -target 选项 编译 代码 , 方便 它 在 较 旧 版 本 的 Java 上 运行 ， 结 
果 它 却 由 于 某 个 方法 调用 失败 而 在 运行 时 崩溃 ? 这 着 实 令 人 费解 ， 但 是 原因 或 许 是 你 忘 了 指定 
-bootclasspath 选项 。 
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如 果 没 有 指定 该 选项 ， 那 么 编译 器 会 创建 指定 版 本 JVM 可 以 理解 的 字 节 码 ( 这 里 还 是 正 
确 的 )， 但 它 会 链接 到 当前 版 本 的 核心 库 API ( 错误 从 这 里 开始 )， 导 致 对 旧版 JDK 中 不 存在 
的 类 型 或 方法 进行 调用 ， 从 而 产生 运行 时 错误 。 

从 Java 9 开始 ， 编 译 器 使 用 --release 选项 来 防止 常见 的 操作 错误 ， 该 选项 会 将 上 述 3 
个 选项 设置 为 正确 的 值 。 


4.5 打包 模块 化 JAR 


在 将 想法 实现 为 可 运行 代码 的 过 程 中 , 编码 和 编译 后 的 下 一 步 是 将 类 文件 打包 成 模块 。 正 如 
3.1.2 节 所 解释 的 那样 ， 这 应 该 产生 一 个 模块 化 JAR 一 一 它 就 像 一 个 普通 JAR， 但 包含 模块 描述 
符 文件 module-info.class。 因 此 ， 你 希望 由 值得 信赖 的 jar 工具 来 负责 打包 工作 。 以 下 是 非常 简 
单 的 创建 模块 化 JAR (本 例 中 为 monitorobserver ) 的 命令 。 


S jar --create 
--file mods/monitor.observer.jar 
-C monitor.observer/target/classes . 


除了 新 的 命令 行 别名 ， 上 述 命令 的 调用 方式 和 Java 9 之 前 版 本 完全 一 致 。 一 个 有 趣 的 隐 含 细 
节 是 ， 因 为 monitor.observer/target/classes 包含 模块 描述 符 modaule-info.class， 所 以 生成 的 
monitor.observer.jar 成 了 一 个 模块 化 JAR。 

虽然 jar 工具 的 工作 方式 与 之 前 类 似 ， 但 依然 有 一 些 与 模块 相关 的 细节 和 补充 值得 关注 ， 
比如 定义 模块 人口 点 。 

















注意 JAR 并 非 交 付 Java 字 节 码 的 唯一 格式 。JEE 还 可 以 使 用 WAR 和 EAR 格式 文件 。 
但 是 在 其 标准 支持 模块 之 前 ， 人 们 还 无 法 创建 模块 化 WAR 或 模块 化 EAR。 


4.5.1 快速 回顾 jar 工 具 


为 了 帮助 理解 ， 先 来 快速 了 解 一 下 jar 是 如 何 打包 归档 的 。 正 如 前 文 所 指出 的 ， 如 果 文 件 
列表 中 包含 模块 描述 符 module-info.class， 那 么 打包 的 结果 是 模块 化 JAR。 

以 打包 monitor.observer 的 命令 为 例 , 打包 的 结果 是 mods 目录 中 的 module.observerjar， 其 中 
包含 了 monitor.observer/target/classes 及 其 子 目录 中 的 所 有 类 文件 。 因 为 classes 中 包含 模块 描述 符 ， 
所 以 JAR 也 将 包含 它 。 因 此 ， 无 须 任 何 额 外 工作 即 可 生成 模块 化 JAR。 


此 操作 模式 表示 创建 包 
$ jar --create < “〈 也 可 使 用 -c) 



































指定 创建 包 的 名 称 
(也 可 使 用 -£) 





--file mods/monitor.observer.jar < 


-C monitor.observer/target/classes . -可 


-C 使 得 jar 将 执行 目录 更 改 到 
指定 的 目录 中 ， 点 〈.) 告诉 它 
要 包含 目录 中 的 所 有 源 文 件 
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在 打包 时 , 应 该 考虑 使 用 --module-version 记录 模块 的 版 本 。13.2.1 节 解 释 了 如 何 做 到 这 
一 点 


AD 


4.5.2 分 析 JAR 


在 使 用 JAR 时 ， 掌 握 对 所 创建 的 包 进 行 分 析 的 方法 十 分 有 意义 ， 尤 其 要 知道 JAR 中 包含 的 
文件 及 其 模块 描述 符 中 的 内 容 。 地 运 的 是 ， 这 两 点 jar 工具 都 能 做 到 。 


1. 列 出 JAR 中 的 内 容 

查看 JAR 中 的 内 容 是 最 显而易见 的 需求 , 这 可 以 通过 --1ist 选项 实现 。 以 下 代码 段 可 以 展 
示 前 文 创建 的 monitorobserverjar 中 的 内 容 。 它 包含 一 个 META-INF 目录 , 但 这 里 不 做 过 多 介绍 ， 
因为 这 个 目录 已 经 存在 多 年 并 日 与 模块 系统 无 关 。 它 还 包含 一 个 模块 描述 符 ， 以 及 monitor. 
observer 包 中 的 DiagnosticDataPoint 和 ServiceObserver 类 。 可 以 说 ， 没 什么 引 人 注 
目 或 令 人 意外 的 。 


$ jar --list --file mods/monitor.observer.jar 














META-INF/ 

META-INF/MANIFEST.MF 

module-info.class 

monitor/ 

monitor/observer/ 
monitor/observer/DiagnosticDataPoint.class 
monitor/observer/ServiceObserver.class 


这 并 不 是 一 条 新 命令 。 它 之 所 以 看 起 来 不 同 , 只 是 因为 拥有 新 的 别名 : --1list 的 简写 是 -t， 
--file 的 简写 是 -f。 在 Java 9 之 前 版 本 中 ，jar -t -f some.jar 的 作用 与 此 相同 。 


2. 检查 模块 描述 符 

模块 描述 符 是 一 个 类 文件 ， 它 由 字 节 码 组 成 。 因 此 有 必要 通过 工具 来 查看 它 的 内 容 。 幸 好 ， 
jar 可 以 使 用 --describe-module (或 者 -da ) 来 实现 。 检 查 monitorobserverjar， 你 会 发 现 它 是 
一 个 名 为 monitor.observer 的 模块 。 该 模块 会 导出 一 个 同名 的 包 ， 同 时 会 依赖 base 模块 。 


$ jar --dqescripe-modqule --file mods/monitor.observer.jar 


A 












































> monitor.observer jar:.../monitor.observer.jar/!'module-info.class 
> exports monitor.observer 
> requires java.base mandated 


( 如 果 想 知道 mandated 的 含义 , 请 回顾 3.1.4 节 。 该 节 提 到 ， 每 个 模块 都 隐 性 地 依赖 于 基础 
模块 ， 这 意味 着 java.base 的 存在 是 强制 性 的 。) 








4.5.3 ”定义 模块 入 口 点 


要 启动 Java 应 用 程序 , 就 要 知道 程序 人 口 点 , 即 把 包含 public static void main(String[]) 
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方法 的 所 有 类 中 的 一 个 类 作为 主 类 。 你 可 以 在 应 用 程序 启动 时 通过 命令 行 来 指定 入 口 点 , 也 可 以 
在 JAR 附带 的 manifest 文件 中 将 其 写 明 ,如果 你 不 知道 这 两 个 选项 的 确切 工作 原理 ,请 不 要 担心 ， 
因为 Java9 增加 了 第 三 个 选项 ， 即 一 种 配合 模块 系统 使 用 的 新 方式 。 

在 使 用 jar 打包 类 文件 时 , 可 以 使 用 --main-class sfclass} 来 定义 主 类 , 其 中 ${class)】 
是 带 有 main 函数 的 类 的 完全 限定 名 称 ( 包 名 后 面 附加 一 个 点 和 类 名 )。 被 指定 的 主 类 将 被 记录 
在 模块 描述 符 中 ,并 且 当 此 模块 成 为 启动 应 用 程序 的 初始 模块 时 , 将 默认 使 用 它 作 为 主 类 ( 详细 
信息 参见 5.1 欧 。 









































尔 习 惯 通过 设置 manifest 中 的 Main-Class 条 目 来 创建 可 执行 的 JAR， 
你 会 很 高 兴 地 了 解 到 jar --main-class 也 起 着 同样 的 作用 。 


ServiceMonitor 应 用 程序 在 monitor.Main 中 有 一 个 人 口 点 ,在 打包 时 可 以 使 用 --main-class 
monitor.Main 来 指明 它 。 


S jar --create 
--file mods/monitor.jar 
--main-class monitor.Main 
-C monitor/target/classes . 


借助 --describe-module 选项 ， 可 以 看 到 该 主 类 已 经 被 记录 在 模块 描述 符 中 。 


$ jar --describe-module 
--file mods/monitor.jar 











> monitor jar:.../monitor.jar/!'module-info.class 

# 省 略 了 requires 和 contains 的 相关 信息 

> main-class monitor.Main 

有 趣 的 是 ,， jar 工具 既 没有 能 力也 没有 责任 来 验证 你 所 指定 的 类 是 否 存在 。 它 既 不 检查 类 是 
否 存在 ， 也 不 检查 类 中 是 否 包含 main 函数 。 如 果 存 在 问题 ， 尽 管 现 阶段 不 会 发 生 错误 ， 但 是 模 
块 启 动 会 失败 。 
































4.5.4 ”归档 选项 
本 章 目 前 只 探讨 了 jar 所 提供 的 一 些 最 重要 的 选项 ， 其 他 一 些 不 同上 下 文中 的 有 趣 选 项 将 
在 后 续 的 相关 章节 中 得 到 阐述 。 为 了 帮助 你 轻松 地 找到 它们 , 表 4-2 列 出 了 jar 工具 与 模块 系统 
相关 的 所 有 选项 。 
表 4-2 按 字母 顺序 排列 的 所 有 与 模块 相关 的 归档 (jar 命令 ) 选项 。 以 下 描述 列 基于 官方 文档 ， 
引用 指向 本 书 中 进行 详细 介绍 的 章节 















































选 项 描 述 引 用 
--hash-modules 记录 所 有 依赖 模块 的 散 列 值 
--describe-module、-d 展示 模块 的 名 称 、 依 赖 关 系 、 导 出 项 、 包 以 及 其 他 相关 信息 4.5.2 节 
--main-class 指定 应 用 程序 人 4.5.3 节 
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( 续 ) 
选 项 描 述 引 用 
--module-path、-p 站 定 查找 应 用 程序 模块 的 位 置 以 记录 散 列 值 3.4 节 
--module-version 指定 编译 器 使 用 的 模块 版 本 13.2.1 节 
--release 为 支持 不 同 的 Java 版 本 ,创建 一 个 包含 字 节 码 的 多 版 本 JAR 附录 忆 
--update 更 新 现 有 的 包 ， 比 如 可 以 添加 更 多 的 类 文件 9.3.3 节 


4.6 ”小 结 








口 确保 选择 的 目录 结构 能 满足 项 目的 需求 。 如 果 有 疑问 ， 请 毫 不 犹豫 地 使 用 构建 系统 的 默 

认 结 构 。 

口 编译 所 有 模块 源 代码 的 javac 命令 (包括 声明 ) 与 Java 9 之 前 版 本 的 命令 基本 相同 ， 只 

是 它 使 用 模块 路 径 而 不 是 类 路 径 。 

口 模块 源 路 径 ( --module-source-path ) 将 告知 编译 器 项 目的 结构 。 这 使 得 编译 器 操作 从 处 理 
类 型 提升 至 处 理 模 块 ， 这 让 你 能 够 使 用 简单 的 选项 ( --module 或 -m ) 来 编译 指定 模块 
及 其 所 有 依赖 ， 而 不 是 仅仅 列 出 源 文件 。 

口 模块 化 JAR 只 是 具有 模块 描述 符 module-info.class 的 普通 JAR。jar 工具 可 以 像 
处 理 其 他 类 文件 一 样 处 理 模 块 描述 符 ， 因 此 要 将 它 完全 打包 到 JAR 中 , 不 需要 添加 新 的 
选项 。 

口 作为 一 个 可 选项 ，jar 允许 人 们 指定 模块 的 入 口 点 (使 用 --main-class )， 入 口 点 指 的 

是 具有 main 函数 的 类 。 这 样 的 方式 使 模块 启动 更 加 简单 。 



















































































运行 和 调试 模块 化 应 用 程序 








本 章 内 容 

口 通过 指定 初始 模块 来 启动 模块 化 应 用 程序 
口 从 模块 中 加 载 资源 

口 验证 模块 、 模 块 集 以 及 模块 图 

口 压缩 和 列 出 可 见 模块 全 集 
口 通过 日 志 调 试 模 块 化 应 用 程序 




















在 根据 第 3 章 和 第 4 章 的 内 容 对 模块 进行 定义 、 编 译 , 并 将 其 打包 成 模块 化 JAR 后 , 最 后 一 
步 就 是 启动 JVM 并 使 用 java 命令 运行 应 用 程序 。 本 章 将 讨论 与 运行 时 相关 的 概念 : 如 何 从 模 
块 中 加 载 资源 (参见 5.2 节 )。 金 无 足 赤 ， 人 无 完 人 ， 人 难免 会 犯错 ， 所 以 5.3 节 也 会 介绍 使 用 各 
种 命令 行 选项 来 调试 模块 配置 的 方法 。 

到 本 章 结束 时 ,你 将 能 够 启动 由 模块 组 成 的 应 用 程序 。 除 此 之 外 ,你 还 将 深入 了 解 模块 系统 
如 何 处 理 给 定 配置 ， 以 及 如 何 通过 日 志 记 录 和 其 他 诊断 工具 来 观察 程序 的 运行 情况 。 

本 章 也 是 第 一 部 分 的 结尾 。 该 部 分 讲述 了 在 编写 、 编 译 和 运行 简单 的 模块 化 应 用 程序 时 需要 
了 解 的 所 有 内 容 。 它 为 第 二 部 分 和 第 三 部 分 将 要 研究 的 更 高 级 的 功能 英 定 了 基础 , 其 中 有 关 如 何 
逐步 迁移 到 模块 系统 的 内 容 尤为 重要 。 


5.1 通过 JVM 启动 模块 化 应 用 程序 


在 所 有 构建 (定义 模块 依赖 关系 和 API, 创建 模块 化 JAR 并 将 它们 放 在 模块 路 径 上 ) 完成 之 
后 ， 让 JVM 在 模块 化 应 用 程序 中 启动 是 非常 容易 的 。 唯 一 要 做 的 就 是 指定 初始 模块 或 者 主 类 。 

java 命令 有 一 个 选项 --module $ {module}, 可 以 用 于 指定 初始 模块 ${module}。 模 块 解析 将 
从 这 里 开始 ， 从 中 还 可 以 启动 一 个 主 类 ， 即 一 个 带 有 public static void main 方法 的 类 。 

该 主 类 由 初始 模块 的 描述 符 定义 ,或 者 使 用 --module $ {module}/${class} 指 定 ， 即 在 
模块 名 称 后 附加 斜 杠 和 完全 限定 类 名 (参见 5.1.1 欧 。 

以 ServiceMonitor 应 用 程序 为 例 ， 所 有 的 准备 工作 都 已 经 就 绪 ， 以 monitor 为 初始 模块 启动 
JVM。 
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$ java 
--module-path mods:libs 
--module monitor 


如 3.4 节 所 述 ，--module-path mods:1ibs 选项 告知 模块 系统 mods 和 libs 目录 包含 
ServiceMonitor 的 应 用 程序 模块 。--module monitor 选项 定义 了 初始 模块 monitor， 于 是 ， 如 
之 前 章节 所 述 ， 模 块 系统 将 解析 所 有 monitor 的 依赖 关系 并 构建 模块 图 。 最 后 ， 如 4.5.3 节 所 述 ， 
它 将 启动 模块 描述 符 中 设置 的 主 类 : monitor .Main。 





5.1.1 指定 主 类 


--module 选项 也 可 以 用 于 指定 应 用 程序 的 主 类 。 为 此 ， 初始 模块 的 名 称 后 要 跟 一 个 正 斜 杠 
和 完全 限定 类 名 ( 包 名 后 跟 一 个 点 和 类 名 )。 

如 下 所 示 ， 通 过 定义 monitor 中 的 monitor .Main， 明 确 告知 应 用 程序 从 何 处 启动 main 
困 数 。 

$ java 


--module-path mods:libs 
--module monitor/monitor.Main 





在 命令 行 上 指定 主 类 会 覆盖 模块 描述 符 定义 的 对 应 内 容 。 这 意味 着 就 像 模块 系统 不 存在 那 
样 ,， 应 用 程序 仍然 可 以 有 几 个 人 口 点 。 如 果 其 中 一 个 是 合理 的 默认 值 ， 就 可 以 将 其 添加 到 模块 描 
述 符 中 ， 就 像 4.5.3 节 所 述 的 那样 。 

如 果 monitor 模块 将 monitor.Main 定义 为 主 类 , 但 出 于 某 种 原因 你 不 想 使 用 它 , 那么 你 可 
以 轻松 地 覆盖 它 。 使 用 以 下 命令 ， 调 用 monitor 中 的 some .other .Mainclass 主 类 启动 应 用 程 
序 ， 可 以 忽略 monitor 的 描述 符 中 定义 的 相应 内 容 。 

$ java 


--module-path mods:libs 
--module monitor/some.other.MainClass 


要 让 上 述 命令 正常 工作 ， 需 要 保证 初始 模块 中 包含 指定 的 主 类 。 所 以 ， 如 果 monitor 模块 中 
没有 some .other .Mainclass 主 类 ,你 将 看 到 以 下 错误 。 





> Error: Could not fingd or load main class 
> some.other.MainClass in module monitor 


5.1.2 ”如 果 初 始 模 块 并 非 主 模块 


如 果 初 始 模块 不 包含 应 用 程序 的 主 类 , 应 该 怎么 办 ? 尽管 这 个 问题 似乎 很 奇怪 , 但 是 软件 开 
发 充满 了 不 确定 性 ， 所 以 这 并 不 意味 着 它 不 会 发 生 。 

例如 ,想象 一 个 桌面 应 用 程序 可 以 以 多 种 模式 (数据 输入 、 评 估 、 管 理 ) 启动 ， 并 且 可 以 通 
过 选择 正确 的 主 类 来 启动 对 应 的 模式 。 青 复杂 一 些 , 应 用 程序 由 许多 模块 组 成 ,每 个 模式 都 有 上 自 
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己 的 模块 ( data.entry、data.evaluation 、 





administration )， 每 个 模式 的 模块 还 包含 相应 的 入 口 点 。 


最 顶层 的 是 app 模块 ， 它 依赖 所 有 的 应 用 程序 模块 ( 图 5-1 展示 了 对 应 的 模块 图 )。 


这 些 模块 包含 可 以 启动 
应 用 程序 的 main 函 数 








应 用 程序 最 顶层 的 模块 
 。。。 宅 依 囊 于 其 他 所 有 应 用 程序 
模块 











更 多 依赖 

















图 5-1 一 个 桌面 应 用 程序 的 模块 图 , 其 中 app 模块 在 最 顶层 , 入 下 有 3 个 模块 
包含 应 用 程序 入 口 点 





要 启动 此 应 用 程序 ， 就 需要 使 用 - 
有 效果 吗 ? 为 了 更 好 地 解决 这 个 问题 ， 











-module app， 然 后 指定 其 他 模块 中 的 一 个 主 类 ， 但 是 这 
首先 定义 一 些 涉及 这 两 个 模块 的 术语 。 





口 当 一 个 模块 依赖 〈 或 传递 地 依赖 ) 应 用 程序 所 需 的 所 有 模块 时 ， 该 模块 称 为 all 模块 。 








口 然后 是 你 想 要 启动 的 ， 包 含 主 类 的 模块 ， 称 为 main 模块 。 


到 目前 为 止 ， 上述 两 个 模块 在 本 书 中 始终 是 相同 的 。 因 此 你 将 它 的 模块 名 称 传递 给 
--module， 使 其 成 为 初始 模块 。 如 果 这 是 两 个 不 同 的 模块 ， 该 怎么 做 ? 
问题 的 关键 在 于 , 模块 系统 中 主 类 的 来 源 雷 打 不 动 。 你 没 办 法 让 它 在 初始 模块 之 外 的 其 他 任 





何 模块 中 搜索 主 类 。 因 此 ， 你 必须 选择 





main 模块 作为 初始 模块 ， 并 将 其 传递 给 --module。 





假设 在 这 种 情况 下 不 能 正确 地 解析 所 有 的 依赖 关系 ,那么 你 将 如 何 确 保 all 的 所 有 依赖 都 被 


考虑 到 ? 此 时 ，3.4.3 节 介 绍 的 --adda- 


modules 选项 派 上 了 用 场 。 有 了 它 ， 你 可 以 将 al 定义 为 





一 个 额外 的 根 模块 ， 并 证 模块 系统 同时 解析 它 的 全 部 依赖 。 





S java 
--module-path mods 
--add-modules all 
--module main 


在 上 文 提 到 的 桌面 应 用 程序 中 ， 这 意味 着 你 需要 始终 使 用 --adaa-modqules app 选项 ， 确 保 
模块 图 中 包含 所 有 必需 的 模块 ， 然 后 选择 所 需 模式 的 模块 作为 主 模块 。 下 面 是 一 个 例子 。 





S java 
--module-path mods 
--add-modules app 
--module data.entry 
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顺便 提 一 下 ,如 果 你 想 知 道 为 什么 各 个 模式 的 模块 并 不 依赖 于 所 有 必需 的 模块 ,下 面 提供 了 
3 个 答案 。 
口 应 用 程序 可 以 通过 服务 解 厢 ， 如 第 10 章 所 述 ，app 就 是 消费 者 。 

口 各 个 模式 的 模块 可 能 有 一 些 可 选 依赖 ， 如 11.2 节 所 述 ，app 的 作用 是 确保 它们 都 存在 。 


口 我 说 这 确实 是 一 个 奇怪 的 案例 ， 还 记得 吗 ? 
5.1.3 ”向 应 用 程序 传递 参数 


将 参数 传递 给 应 用 程序 和 以 前 一 样 简单 。JVM 将 初始 模块 之 后 的 所 有 内 容 放 入 一 个 字符 串 
数组 中 (方便 在 空间 上 进行 拆 分 )， 并 将 其 传递 给 main 函数 。 
假设 用 以 下 方式 调用 ServiceMonitor， 你 认为 会 把 什么 传递 给 Main: :main? (注意 ,这 是 
一 个 很 诡异 的 问题 ! ) 
$ java 
--module-path mods:libs 
--module monitor 
--add-modules monitor.rest 
opt arg 
这 个 问题 的 诡异 之 处 在 于 ，--add-modules monitor .rest 选项 看 起 来 像 是 模块 系统 需要 
处 理 的 内 容 。 如 果 这 个 选项 在 正确 的 位 置 ， 即 在 --module 之 前 ,那么 本 该 如 此 ; 但 是 在 上 述 调 
用 中 ， 它 位 于 --module 之 后 ， 这 种 情况 下 JVM 将 其 解释 为 应 用 程序 的 选项 并 将 其 传递 给 应 用 
为 了 更 好 地 解释 这 个 问题 ， 扩 展 Main: :main 让 其 打印 出 参数 列表 。 
public static void main(String[] args) { 


for (String arg : args) { 
System.out.print (arg + " / "); 










































































于 是 ， 你 将 看 到 的 真实 输出 内 容 是 : --add-modules / monitor.rest / opt / argo 
所 以 , 请 小 心 处 理 --module, 将 其 作为 你 希望 JVM 处 理 的 最 后 一 个 选项 ,并 且 将 所 有 的 应 
用 程序 选项 置 于 其 后 。 


5.2 ”从 模块 中 加 载 资源 


3.3 节 详 细 介 绍 过 模块 系统 的 可 访问 性 规则 如 何 提供 跨 模块 边界 的 强 封 装 性 。 但 是 这 部 分 只 
讨论 了 类 型 ， 在 运行 时 你 通常 也 需要 访问 相关 的 资源 。 无 论 这 些 资源 是 配置 、 国 际 化 文件 、 媒 体 
文件 , 还 是 (在 某 些 情况 下 ) 原始 的 .class 文件 , 代码 都 可 以 从 项 目 附 带 的 JAR 中 加 载 这 些 文件 。 
因为 JPMS 将 模块 化 JAR 转换 为 模块 , 并 声称 对 它们 内 部 进行 了 强大 的 封装 , 所 以 人 们 需要 探索 
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它 对 资源 的 加 载 有 何 影 响 。 在 深入 探讨 之 前 ,下 面 几 节 将 先 简要 回顾 资源 以 前 是 如 何 加 载 的 , 并 
指出 它 在 Java 9 及 以 上 版 本 中 的 变化 。 之 后 ， 本 章 将 仔细 研究 如 何 跨 模块 边界 加 载 包 中 的 资源 。 








建议 资源 访问 的 主题 在 本 书 中 出 现 了 好 几 次 :6.3 节 介绍 了 如 何 访问 JDK 的 资源 ,8.2.1 
节 介 绍 了 对 非 模块 化 资源 的 访问 。 有 关 加 载 资源 的 实际 演示 ， 请 查看 ServiceMonitor 的 


feature-resources 分 支 。 





5.2.1 Java 9 之 前 的 资源 加 载 


由 于 在 Java 9 之 前 版 本 中 JAR 之 间 没 有 边界 ， 因 此 那 时 每 个 类 都 可 以 访问 类 路 径 上 的 所 有 
资源 。 这 比 类 型 的 可 访问 性 问题 更 严重 , 因为 至 少 类 型 可 以 使 用 包 可 见 性 规则 使 自身 隐藏 在 包 中 ， 
而 对 于 资源 的 访问 不 存在 类 似 的 规则 。 

















定义 为 了 加 载 资源 ， 人 们 会 在 Class 或 ClassLoader 上 调用 getResource 
或 getResourceAsStreanm 方法 。 从 概念 上 来 讲 ， 这 些 方法 几乎 完全 相同 : 你 将 
资源 文件 的 名 称 作为 String 传递 给 它们 ， 如 果 找 到 文件 ， 它 们 将 返回 一 个 URL 
或 InputStream 实例 ; 否则 ， 将 返回 一 个 null。 为 了 简化 这 个 过 程 ， 方 便 人 们 
理解 ， 本 书 采用 Class: :getResoutrce 的 写法 。 


代码 清单 5-1 展示 了 如 何 加 载 各 种 资源 。 只 要 所 有 类 和 资源 都 在 类 路 径 上 , 那么 它们 在 哪个 
JAR 中 无 关 紧 要 。 图 5-2 展示 了 包含 所 有 已 加 载 资 源 的 单个 JAR 一 一 如 果 它 在 类 路 径 上 ， 那 么 每 
次 调用 class: :getResource 都 将 返回 一 个 URL 实例 。 


代码 清单 5-1 加 载 资源 : 它们 都 在 类 路 径 上 ， 因 此 全 部 都 能 成 功 


为 了 调用 class: :getResource， 你 首先 需要 一 个 类 
的 实例 一 一 另外 两 个 anchor 类 也 可 以 正常 工作 

















头 号 径 、 
Class<?> anchor = Class 0 
.forName ("monitor.resources.opened.Anchor") Anchor H. 
URL pack = anchor.getResource ("file.txt"); -十 作为 绝对 路 径 解析 
(由 于 前 面 的 “/”) 的 
URL root = anchor.getResource("/file.txt"); 十 一 JAR 的 根 节 点 





URL meta = anchor.getResource("/META-INF/file.txt"); Se 
g META-INF 可 以 通过 


寺中 公证 
URL bytecode = anchor .getResource("Anchor .class"):; 绝对 路 径 访问 


加 载 anchor 的 字 节 码 
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monitor.resources.jar 在 META-INF 目 录 下 的 file.txt 
国 META-INF ee 资源 文件 


file.txt 
目 MANIFESTMF 
国 monitor 
国 resources 
国 closed 
国 Anchor.class 每 个 包 有 自己 的 Anchor 类 和 
目 file.txt file.txt 资 源 文件 
国 exported 
国 Anchorclass 
上 fe.xt 
国 opened 
国 Anchor.class 
上 fiemt 在 JAR 根 目录 下 的 file.txt 
目 file.txt 资源 文件 
图 5-2 ”名 为 monitorpersistence 的 JAR， 其 中 存 有 一 些 资源 一 一 凑巧 的 是 ， 
正好 对 应 着 代码 清单 5-1 中 的 内 容 


























5.2.2 Java 9 及 以 上 版 本 的 资源 加 载 


你 可 能 想 知道 为 什么 代码 清单 5-1 给 出 了 这 么 多 不 同 的 例子 。 这 是 因为 ， 其 中 一 些 例子 可 以 
在 模块 下 工作 ， 而 另 一 些 不 可 以 ， 后 文 将 逐一 介绍 。 不 过 ， 在 进行 讨论 之 前 ， 先 考虑 一 下 Java9 
中 的 各 种 资源 API。 
口 class 中 的 方法 是 从 模块 中 加 载 资 源 的 好 方法 一 一 后 文 将 深入 探索 这 种 方式 。 
口 ClassLoader 中 的 方法 在 涉及 模块 时 ,往往 会 产生 不 同 且 不 太 有 用 的 行为 ， 所 以 不 会 进 
行 讨论 。 如 果 你 仍 想 使 用 ， 请 参考 它们 的 Javadoc。 
口 作为 新 类 ， java.lang.Module 中 也 有 对 应 的 方法 : getResourc 和 getResource-— 
AsStream。 12.3.3 节 将 对 此 进行 深入 探讨 ,它们 的 行为 与 class 中 方法 的 行为 非常 相似 。 
随 着 这 个 问题 尘埃 落 定 ,可 以 开始 使 用 重要 的 方法 class: :getResource 从 模块 中 加 载 代 
码 清单 5-1 中 的 各 种 资源 了 。 第 一 个 重要 的 发 现 是 ， 在 同一 个 模块 中 ， 每 个 调用 都 返回 一 个 URL 
实例 , 这 意味 着 所 有 资源 都 被 找到 了 。 你 会 发 现 无 论 模块 封装 了 哪些 包 都 是 如 此 ; 然而 在 跨 模 块 
边界 加 载 资源 时 ， 情 况 会 有 所 不 同 。 
口 默认 情况 下 ， 包 中 的 资源 是 被 封装 的 〈 详细 信息 参见 5.2.3 节 )。 
口 JAR 的 根 目 录 或 名 称 无 法 映射 到 包 的 目录 ( 比如 META-INF， 这 是 因为 目录 名 无 法 包含 
破 折 号 ) 中 的 资源 永远 不 会 被 封装 。 
口 .class 文件 永远 不 会 被 封装 。 
口 如 果 资 源 是 被 封装 的 ， 那 么 执行 getResource 调用 将 返回 null。 
在 大 多 数 访问 形式 下 ， 资 源 未 被 封装 的 原因 可 归结 为 “方便 迁移 "。Java 生态 系统 中 的 许多 
关键 且 使 用 广泛 的 工具 和 框架 ， 往 往 依赖 位 于 JAR 根 目录 或 META-INF 目录 中 的 配置 (例如 ， 
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JPA 实现 ), 或 需要 扫描 .class 文件 ( 例如, 查找 带 注解 的 类 )。 如 果 默 认 情 况 下 所 有 资源 都 得 到 封 
装 ， 那 么 在 同样 的 默认 情况 下 ， 这 些 工 具 不 能 与 模块 一 起 使 用 。 

同时 ， 对 资源 进行 强 封装 带 来 的 好 处 远 远 少 于 类 型 ， 因 此 人 们 决定 仅 将 资源 封装 在 包 中 。 下 
面 看 一 下 如 何 绕 开 对 资源 的 封装 。 


5.2.3 ”跨越 模块 边 表 加 载 包 中 资源 


只 要 class: :getResource 或 其 他 类 似 方法 的 任务 是 加 载 资 源 ， 它 就 会 检查 路 径 是 否 符 合 
名 。 简 单 来 说 ， 如 果 删 除 路 径 中 的 文件 名 ,然后 将 所 有 的 “/” 替 换 为 “.”， 产生 的 结果 是 一 个 
有 效 的 包 名 ， 那 么 资源 将 从 包 中 加 载 。 
让 我 们 从 代码 清单 5-1 中 选 一 些 代 码 作为 示例 ,代码 anchor.getResource ("file.txt") 
告诉 JVM 基于 类 实例 anchor 加 载 资源 file.txt。 因 为 该 类 在 本 示例 中 位 于 monitor. 
resources.opened 包 中 ， 所 以 从 该 包 中 加 载 资 源 。 
一 个 反例 是 anchor .getResource("/META-INF/file.txt")， 其 中 的 正和 斜 杠 (“/) 表 
示 绝 对 路 径 〈 因 此 anchor 在 哪个 包 中 无 关 紧要 )， 尝 试 将 其 转换 为 包 名 将 产生 META-INF。 这 
在 Java 中 不 是 一 个 有 效 的 包 名 ， 因 此 资源 不 会 从 包 中 得 到 加 载 。 







































































打开 包 

了 解 JVM 如 何 确 定 资源 是 否 在 包 中 是 非常 重要 的 ， 因 为 如 果 资 源 位 于 包 中 ， 它 将 受到 强 
封装 。 此 外 ，exports 语句 不 提供 资源 访问 权限 。 而且 ， 由 于 getResource 使 用 反射 APT， 
因此 需要 不 同 的 机 制 来 访问 资源 。 

到 目前 为 止 ， 本 书 尚 未 讨论 这 种 情况 , 但是， 要 授予 针对 资源 的 访问 权限 ， 就 需要 opens 
语句 。 从 语法 上 讲 ， 它 的 工作 方式 与 exports 完全 一 样 ， 但 是 它 仅 提供 对 包 的 反射 访问 ， 这 
使 它 非常 适合 上 述 情况 。 





关于 opens 指令 还 有 很 多 东西 需要 学 习 ，12.2 节 将 详细 讨论 ， 但 在 这 里 你 需要 了 解 的 是 ， 
它 提供 了 访问 封装 包 中 资源 的 途径 。 现 在 ， 尝 试 围绕 代码 清单 5-1 中 加 载 的 资源 构建 
monitor.resources 模块 ， 以 下 是 模块 声明 。 


module monitor.resources { 
exports monitor.resources.exported; 
opens monitor.resources.opened; 





























} 
与 图 5-2 进行 比较 ,可 以 看 到 资源 在 3 个 包 中 , 即 encapsulated、exported 和 opened。 











如 果 运 行 代码 清单 5-2 中 的 代码 会 有 什么 结果 ? 
代码 清单 5-2 ”从 具有 不 同 可 访问 性 的 包 中 加 载 资源 
URL closed = Class a 
.forName ("monitor.resources.closed.Anchor") 无 法 从 封装 包 中 
加 载 资 源 





.getResource ("file.txt"); | 
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URL exported = Class 








.forName ("monitor.resources.exported.Anchor") 人 
.getResource ("file.txt"); 后 加 载 资源 
URL opened = Class 
.forName ("monitor.resources.opened.Anchor") a 
贫 痕 


.getResource ("file.txt"); 








执行 结果 取决 于 代码 所 属 的 模块 。 如 果 所 属 模块 是 monitorresources 模块 ， 则 执行 成 功 ， 
为 封装 仅 在 模块 边界 起 作用 ; 如 果 其 他 模块 运行 这 些 代码 ， 则 只 有 monitor.resources. 
opened 包 可 以 得 到 反射 访问 。 因 此 ，getResource 仅 在 opened 情况 下 返回 非 空 URL， 而 在 
closed 和 exported 情况 下 加 载 资源 将 返回 nul1l。 

代码 清单 -1 中 的 其 他 调用 getResource("Anchor.class") ,getResource ("/file. 
txt") 和 getResource("/META-INF/file.txt") 将 执行 成 功 , 因为 它们 加 载 字 节 码 或 不 在 包 
中 的 资源 。 如 5.2.2 节 所 述 ， 这 些 都 未 被 封装 。 

总 之 ， 如 果 想 访问 某 个 包 中 的 资源 ， 而 这 个 包 属 于 一 个 模块 ， 那 么 必须 将 这 个 包 打 开 。 

以 打开 包 的 方式 授予 对 资源 的 访问 权限 会 导致 其 他 代码 依赖 模块 的 内 部 结构 。 为 了 避免 这 种 
情况 , 请 考虑 用 公有 API 公开 加 载 资源 的 类 型 。 然 后 , 你 可 以 在 内 部 随意 调整 资源 ， 而 不 会 破坏 
其 他 模块 。 


提示 ”如果 要 避免 依赖 包含 资源 的 模块 ， 则 可 以 改 为 创建 服务 。 第 10 章 将 介绍 服务 ， 
使 用 它 访 问 资 源 将 非常 简单 。 幸 好 ， 有 一 份 文档 很 好 地 讲解 了 它 的 使 用 方法 ， 因 此 这 里 
就 不 再 进行 重复 讲解 了 ,请 查看 ResourceBundleProvider 的 Javadoc, 人 苞 考 Java 10 
或 以 上 版 本 的 文档 。 尽 管 它 的 工作 方式 与 Java 9 相同 ， 但 其 文档 更 清晰 。 


5.3 ”调试 模块 及 模块 化 应 用 程序 


模块 系统 解决 了 复杂 的 问题 ,并 具有 宏大 的 目标 。 我 认为 它 效果 很 好 ,其 使 简单 的 用 例 简单 
易 用 。 但 不 要 自欺欺人 , 这 套 系 统 的 运行 原理 相当 复杂 ， 出 错 并 不 奇怪 。 当 你 进入 本 书 的 后 两 个 
部 分 ， 即 探讨 模块 系统 的 迁移 及 其 更 高 级 的 功能 时 更 是 如 此 。 在 这 种 情况 下 ， 痢 视 一 下 模块 系统 
的 内 部 工作 原理 将 很 有 帮助 。 幸 好 ， 它 提供 了 以 下 几 种 方法 来 做 到 这 一 点 : 
D 分 析 和 验证 模块 ; 
D 测试 构建 模块 图 ; 
口 检查 可 见 模块 全 集 ; 
口 在 解析 过 程 中 排除 模块 ; 
口 日 志 记 录 模 块 系统 行为 。 
后 文 各 节 会 对 它们 进行 逐个 介绍 。 


5.3.1 分 析 单 个 模块 


你 已 经 看 到 jmod describe 展示 了 JMOD 的 模块 属性 (参见 3.1.1 欧 ，jar --describe- 
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mogdule 也 对 JAR 执行 了 类 似 的 操作 (参见 4.5.2 节 )。 这 些 都 是 检查 单个 工件 的 好 方法 。 另 一 种 
稍 有 不 同 的 方式 是 在 java --describe-module 后 附加 了 模块 名 称 ， 此 选项 打印 相应 工件 的 路 
径 以 及 模块 描述 符 。 模 块 系统 不 执行 任何 其 他 操作 ， 既 不 解析 模块 也 不 启动 应 用 程序 。 

因此 ，jmog descripbe 和 jar --describe-module 操作 工件 , 而 java --describe 
操作 模块 。 尽 管 在 不 同情 况 下 它们 的 便利 程度 不 同 ， 但 最 终 的 输出 是 相似 的 。 

再 次 转向 ServiceMonitor， 你 可 以 使 用 --describe-module 查看 其 模块 以 及 平台 模块 的 描 
述 符 。 

$ java 


--module-path mods 
--describe-module monitor.observer 


























> monitor.observer file:...monitor.observer.jar 
exports monitor.observer 
requires java.base mandated 


VV 


S java 
--module-path mods 
--describe-module java.sql 


java.sgql@9.0.4 

exports java.sql 

exports javax.sql 

exports javax.transaction.xa 
requires java.base mandated 
requires java.logging transitive 
requires java.xml transitive 
uses java.sql.Driver 


5.3.2 ”验证 模块 集 


研究 单个 模块 对 分 析 已 知 问题 非常 有 用 。 但 是 未 知 问题 呢 ? 模块 路 径 是 否 有 重复 的 模块 ? 
否 有 模块 会 造成 包 分 裂 ? 

java 选项 --validate-modules 会 扫描 模块 路 径 中 的 错误 。 它 会 报告 重复 的 模块 和 分 裂 的 
包 ， 但 不 会 生成 模块 图 ， 因 此 无 法 发 现 缺 少 的 模块 或 循环 依赖 。 在 执行 检查 后 ，java 退出 。 

此 示例 创建 了 一 个 monitorrest 模块 ,与 monitor.observer 一 样 ,其 中 包含 monitor .observer 
包 。 验 证 模块 的 结果 如 下 。 

$ java 


--module-path mods 
--validate-modules 





江 











# 省 略 了 标准 化 Java 模块 

# 省 略 了 非 标准 化 JDK 模块 

> file:.../monitor.rest.jar monitor.rest 

> file:.../monitor.observer.beta.jar monitor.observer.beta 
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> file:.../spark.core.jar spark.core 

S30 fe. /MonNnitor etatlietics. Jar monreor.. Statistlies 

> file:.../monitor.jar monitor 

> file:.../monitor.observer.jar monitor.observer 

contains monitor.observer conflicts with module monitor.rest 
> file:.../monitor.persistence.jar monitor.persistence 

> file:.../monitor.observer.alpha.jar monitor.observer.alpha 

> file:.../hibernate.jpa.jar hibernate.jpa 


输出 首先 列 出 了 所 有 没有 错误 的 JDK 模块 ， 然 后 继续 处 理应 用 程序 模块 。 它 列 出 了 扫描 过 
的 JAR 文件 和 在 其 中 发 现 的 模块 以 及 monitor.rest 和 monitor.observer 之 间 的 包 分 裂 问题 。 


5.3.3 ”验证 模块 图 


竹 助 --ary-run 选项 , JVM 执行 了 完整 的 模块 解析 , 包括 构建 模块 图 和 验证 配置 的 可 靠 性 ， 
但 在 执行 main 函数 之 前 该 过 程 就 停止 了 。 这 听 起 来 可 能 并 不 是 特别 有 用 , 但 我 发 现 它 确实 有 用 。 
在 有 错误 的 命令 中 使 用 --ary-run 可 以 防止 应 用 程序 启动 ， 而 不 会 更 改 任何 内 容 。 在 排除 错误 
后 ,命令 会 执行 成 功 并 退出 ， 你 会 返回 到 命令 行 。 这 使 你 能 够 快速 检验 命令 行 选项 ,直至 得 到 正 
确 结果 ， 而 不 需要 不 断 地 启动 和 中 止 应 用 程序 。 

作为 错误 命令 的 示例 ,下 面 将 尝试 在 没有 模块 路 径 的 情况 下 启动 ServiceMonitor。 不 出 预料 ， 
启动 失败 ， 因 为 没有 应 用 程序 模块 的 搜索 路 径 模块 系统 就 无 法 找到 初始 模块 monitor。 


$ java --module monitor 



































> Error occurred during initialization of boot layer 
> java.lang.module.FindException: 
> Module monitor not found 


添加 --dry-run 选项 不 会 改变 任何 内 容 。 


$ java --dry-run --module monitor 





> Error occurred during initialization of boot layer 
> java.lang.module.FindException: 
> Module monitor not found 


下 面 是 一 条 可 以 正常 工作 的 命令 。 


$ java 
--module-path mods:libs 
Et Sh sav h elb lan 
--module monitor 


该 命令 没有 任何 输出 。 由 于 命令 正确 且 模 块 系统 运行 正常 ， 因 此 它 在 模块 解析 后 退出 , 没有 
返回 任何 信息 。 

根据 5.1.2 市 的 内 容 ，--dry-run 必须 放置 在 --module 之 前 ， 哪 怕 这 样 的 顺序 看 起 来 令 人 
不 快 。 这 里 给 专业 人 士 提 个 醒 : 如 果 你 使 用 自 定义 类 加 载 程序 、 自 定义 安全 管理 器 或 代理 ， 那 么 
即使 使 用 了 --gdry-run 它们 也 照样 会 启动 。 
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5.3.4” 列 出 可 见 模块 及 其 依赖 


你 已 





经 使 用 过 3.1.1 节 中 的 选项 --1ist-modules， 即 通过 java --list-modules 列 出 当 


前 运行 时 的 所 有 平台 模块 。 更 好 地 理解 模块 系统 的 工作 原理 ， 可 以 让 你 超越 上 述 内 容 。 


1. 列 出 可 见 模块 全 集 
--list-modules 选项 可 以 列 出 可 见 模块 全 集 。 模块 系统 不 执行 任何 其 他 操作 , 既 不 解析 模 


块 ， 也 不 启动 应 用 程序 。 














如 3.1.4 节 所 述 ， 可 见 模块 全 集 由 平台 模块 ( 运行 时 中 的 模块 ) 和 应 用 程序 模块 ( 模块 路 径 
上 的 模块 ) 组 成 。 在 解析 期 间 ， 从 该 集合 中 选取 模块 生成 模块 图 。 应 用 程序 永远 不 能 包含 
--list-modules 未 列 出 的 模块 。( 但 请 注意 , 许多 可 见 模块 很 可 能 不 在 图 中 ,这 是 因为 任何 根 
模块 都 没有 直接 或 传递 地 依赖 它们 。 ) 


在 调用 









































java --1ist-moqules 时 ，JVM 列 出 可 见 模块 全 集 。 由 于 没有 指定 模块 路 径 ， 
只 有 运行 时 的 平 合 模块 会 咎 打印 





请 看 一 个 稍稍 重要 些 的 示例 。 列 出 ServiceMonitor 应 用 程序 的 mod 和 libs 目录 中 的 模块 。 


S java 


--module-path mods:libs 
--list-modules 


> spar 


KCOrTe 


# 省 略 了 Spark 依赖 


# 省 略 了 


标准 化 Java 模块 


# 省 略 了 非 标准 化 JDK 模块 


> moni 
> moni 


> monit 


> moni 
> moni 
> moni 
> moni 


ET 


tor. 
(ea 
EOE 
tor.persistence 
Cors 
tor. 


observer 
observer.alpha 
observer.beta 


rest 
statistics 


> hibernate.jpa 
# 省 略 了 Hibernate 依赖 


如 果 在 常规 的 JDK 安装 中 执行 ， 那 么 输出 将 非常 多 ， 因 为 它 列 出 了 大 约 100 个 平台 模块 。 
它 包 含 模 块 路 径 上 的 所 有 模块 。 总 之 , 这 些 对 于 查看 可 以 从 哪些 模块 构建 模块 图 非常 有 用 , 但 也 














容易 导致 “一 叶 障 目 ， 不见 泰山 ”。 不 过 ， 有 一 种 方法 可 以 将 输出 限制 在 一 个 合理 的 子 集 中 ， 接 
下 来 将 进行 研究 。 


2. 列 出 传递 依赖 

可 见 模块 长 长 的 列表 有 一 个 有 趣 的 子 集 ， 这 就 是 初始 模块 的 传递 依赖 。 幸 好 ,你 可 以 通过 选 
项 --1imit-mogdules 将 长 列表 缩短 为 该 子 集 。 下 文 马 上 就 会 解释 它 的 工作 原理 。 现 在 请 相信 我 
当 我 将 它 与 --1ist-modules 选项 一 并 提 及 时 ， 你 可 以 用 它 来 打印 任何 给 定 模块 的 所 有 传递 依 


赖 的 列表 。 
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以 下 是 用 一 些 平 台 模块 做 的 实验 。 
$ java --limit-modules java.xml --list-modules 


ava.base 
ava.xml 
ava --limit-modules java.sql --list-modules 


ava.base 

ava.logging 

ava.sql 

ava.xml 

ava --limit-modules java.desktop --list-modules 


> java.base 

> java.datatransfer 
> java.desktop 
:3 
光 





java.prefs 
java.xml 





你 可 以 看 到 java.xml 仅 依赖 于 java.base，SQL 模块 使 用 日 志和 XML 功能 ， 甚 至 会 看 到 尽管 
Java.desktop 包括 AWT 、Swing、 某 些 媒体 API 和 JavaBeans API， 但 它 只 有 少量 依赖 (尽管 原因 
并 不 重要 一 一 它 是 一 个 包含 很 多 功能 的 复杂 模块 )。 

你 也 可 以 使 用 此 方法 检查 应 用 程序 模块 。 一旦 应 用 程序 发 展 到 包含 许多 模块 , 这 将 变 得 特别 
有 用 ， 因 为 人 们 很 快 就 会 难以 记 住所 有 模块 。 

再 次 查看 ServiceMonitor 并 检查 其 中 一 些 模块 的 依赖 。 
ER mods:libs 
--limit-modules monitor.statistics 
--list-modules 
































java.base 

monitor.observer 

monitor.statistics 

java 
--module-path mods:libs 
--limit-modules monitor.rest 
--list-modules 


VY YY 


spark.core 

省 略 了 Spark 依赖 
Java.base 
monitor.observer 
monitor.rest 
monitor.statistics 


组 合 使 用 --1imit-modules 和 --1list-modules 后 可 以 看 到 ，monitor.statistics 仅 依赖 于 
monitor.observer( 无 所 不 在 的 基础 模块 )， 并 且 monitor.rest 引入 了 Spark 的 所 有 依赖 。 
现在 是 时 候 看 下 --1imit-modules 的 工作 原理 了 。 


V V VV #9V 
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5.3.5 在 解析 过 程 中 排除 模块 


你 刚刚 使 用 --1imit-modules 来 减少 --1list-modules 的 输出 ， 它 是 如 何 工 作 的 ? 鉴于 
--1ist-modqules 会 打印 可 见 模块 全 集 ,--1imit-modules 显然 对 它 的 输出 进行 了 限制 ,并 且 ， 
由 于 可 以 使 用 它 查 看 某 个 模块 所 有 的 传递 依赖 , 因此 模块 系统 必须 对 这 些 选 项 进行 评估 。 总 的 来 
说 ， 这 两 个 观察 结果 基本 说 明了 这 个 选项 的 功能 。 

选项 --1imit-modules ${modules} 接 受 由 逗号 分 隔 的 模块 名 称 列表 ， 它 限定 了 特定 模块 
的 可 见 模块 全 集 及 其 传递 依赖 。 如 果 --add-modules (参见 3.4.3 节 ) 或 --module (参见 5.1 
节 ) 选项 与 --1imit-modules 一 起 使 用 ,那么 这 两 个 选项 指定 的 模块 会 变 得 可 见 ， 但 它们 的 依 
赖 并 不 可 见 ! 

模块 系统 评估 该 选项 的 步 又 如 下 。 

(1) 从 --limit-modules 指定 的 模块 开始 ，JPMS 确定 其 所 有 传递 依赖 ， 这 符合 3.2.1 节 中 
关于 可 靠 配 置 的 要 求 。 

(2) 如 果 使 用 --add-modules 或 --module 选项 ,那么 JPMS 将 添加 相应 模块 (但 不 添加 其 
依赖 )。 

(3) PMS 将 生成 的 集合 作为 可 见 模 块 全 集 ， 在 随后 的 步骤 (如 列 出 模块 或 启动 应 用 程序 ) 中 
使 用 。 

下 面 使 用 --1imit-modules 进行 一 些 实验 ,以 说 明 它 的 工作 原理 。 首 先 ， 列 出 monitorrest 
的 所 有 传递 依赖 。 


$ java 
--module-path mods:libs 
--limit-modules monitor.rest 
--list-modules 













































































java.base 

为 了 简化 输出 
文件 路 径 会 从 中 省 略 
monitor.observer 
monitor.rest 
monitor.statistics 
spark.core 


然后 ， 回 看 图 2-4， 检 查 这 些 依赖 项 是 否 正确 。 如 果 现 在 尝试 启动 应 用 程序 ， 会 发 生 什么 ? 
为 此 你 必须 用 --module monitor 替换 --1ist-modules 选项 。 


S java 
--module-path mods:libs 
--limit-modules monitor.rest 
--module monitor 


V V VV 间 大 VV 





























Error occurred during initialization of boot layer 
java.lang.module.FindException: 

Module monitor.persistence not foungd, 

required by monitor 
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结果 展示 了 --1imit-modules 的 工作 原理 的 两 个 方面 。 
口 使 用 --module 选项 让 指定 的 初始 模块 变 得 可 见 ( 否则 会 出 现 找 不 到 monitor 模块 的 异 
削 。 
口 初始 模块 的 依赖 均 不 可 见 ( 否则 应 用 程序 将 启动 )。 
--add-modules 也 是 如 此 ， 因 此 添加 aaq-modqules monitor.persistence 后 ， 可 以 期 
望 看 到 以 下 效果 。 
口 由 于 现在 monitor.persistence 是 可 见 的 ， 因 此 与 之 相关 的 错误 应 该 消失 。 
口 由 于 其 依赖 hibernate.jpa 是 不 可 见 的 ， 因 此 预期 会 出 现 相应 错误 。 
下 面试 一 下 。 
$ java 
--module-path mods:libs 
--limit-modules monitor.rest 


--add-modules monitor.persistence 
--module monitor 














Error occurred during initialization of boot layer 
java.lang.module.FindException: 
Module monitor.observer.alpha not foungd, 
required by monitor 


图 5-3 对 这 个 例子 进行 了 详细 展示 。 


--l1imit-modules 指 定 的 模块 及 其 除 平台 模块 之 外 monitor .rest 
传递 依赖 (必须 存在 于 JDK 中 或 者 模 所 依赖 的 模块 


> 
> 
这 
> 











块 路 径 中 ) 是 可 见 的 
--limit-modules monitor.rest 


一 一 人 过 core ) 


--add-modules monitor.persistence 全 (monitor persistence ) 
--module monitor —> ( monitor 
































add iles 和 --module 指 定 后 续 模 块 解析 所 使 用 的 可 见 模块 全 集 
的 醒 决 是 可 见 的 ， 但 是 它 : 们 的 依 入 
并 不 可 见 
5-3 --1limit-modqules 选项 在 模块 解析 之 前 生效 
可 恶 ， 因 为 observer 的 实现 也 丢失 了 ， 所 以 你 不 可 能 找到 Hibernate。 才 好， 以 通过 增加 
更 多 的 --add-modules 选项 来 解决 。 





$ java 
--module-path mods:libs 
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--limit-modules monitor.rest 

--add-modules monitor.persistence, 
monitor.observer.alpha,monitor.observer.beta 

--module monitor 


> Error occurred during initialization of boot layer 
> java.lang.module.FindException: 


2 Module hibernate.jpa not foungd, 
required by monitor.persistence 
这 样 就 成 功 了 1! 


在 前 面 的 小 节 中 , 你 通过 可 见 模块 全 集 列 出 了 所 有 被 引用 的 模块 , 进而 有 效 地 打印 出 了 一 些 
模块 的 传递 依赖 ,但 这 并 不 是 --1imit-modules 的 唯一 用 例 。 第 10 章 在 讨论 服务 的 时 候 ， 会 
添加 更 多 用 例 。 


5.3.6 通过 日 志 信息 观察 模块 系统 


最 后 ， 了 解 一 下 调试 的 “灵丹妙药 ”: 日 志 信息 。 任 何 情况 下 在 一 个 系统 出 错时 直接 查看 出 
错 的 位 置 (不 论 什 么 样 的 错误 ) 都 很 难 定位 问题 的 根源 。 这 时 候 应 该 检查 一 下 日 志 。 

你 有 可 能 正面 对 一 个 非常 罕见 的 问题 。 要 解决 这 类 问题 ， 了 解 提 取 日 志和 相关 信息 的 方法 ， 
以 及 日 志 在 正常 情况 下 的 应 有 状态 会 非常 有 帮助 。 本 节 不 会 讨论 如 何 修复 某 个 具体 的 问题 ， 而 会 
为 你 介绍 一 些 有 助 于 实践 的 工具 。 
模块 系统 撰写 日 志 的 机 制 有 两 种 ， 一 种 配置 起 来 比较 简单 ， 男 一 种 则 相对 复杂 : 
口 解析 器 诊断 信息 ; 
口 JVM 联合 日 志 。 
以 上 两 种 机 制 本 节 都 会 介绍 ， 先 从 简单 的 开始 。 


1. 模块 解析 期 间 诊 断 信息 

借助 --show-module-resolution 选项 , 模块 系统 会 在 模块 解析 期 间 打印 信息 。 下 面 是 在 
使 用 这 个 选项 时 启动 ServiceMonitor 应 用 程序 得 到 的 输出 。 它 展示 了 根 模块 (本 例 中 只 有 一 个 小 
作为 依赖 被 加 载 的 模块 ， 以 及 这 个 被 加 载 的 模块 是 谁 的 依赖 。 


$ java 和 
--module-path mods:libs At 


--show-module-resolution 信息 
--limit-modules monitor < 

--dry-run 姑 
--module monitor 



































你 只 想 看 到 解析 信息 ， 所 以 没 必要 








monitor requires monitor.rest 
monitor requires monitor.persistence 


启动 应 用 程序 
# 对 于 文件 列 出 的 每 个 模块 可 见 模块 全 集 需 要 被 限制 ， 否 则 会 
# 为 了 简洁 将 其 删除 ， 但 它 也 有 所 帮助 有 太 多 意 想不到 的 模块 被 解析 出 
> root monitor 来 。 伴 随 着 服务 的 引入 ， 原 因 也 逐 
> monitor requires monitor.observer 渐变 得 清 
2 
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monitor requires monitor.observer.alpha 

monitor requires monitor.observer.beta 

monitor requires monitor.statistics 

monitor.rest requires spark.core 

monitor.rest requires monitor.statistics 
monitor.persistence requires hibernate.jpa 
monitor.persistence requires monitor.statistics 
monitor.observer.alpha requires monitor.observer 
monitor.observer.beta requires monitor.observer 





monitor.statistics requires monitor.observer 

省 略 了 Spark 依赖 

省 略 了 Hibernate 依赖 

从 模块 系统 中 提取 解析 器 的 诊断 信息 非常 简单 ， 但 该 过 程 不 支持 定制 化 。 因 此 ,是 时 候 转 向 
复杂 但 也 更 强大 的 机 制 了 。 


2. 使 用 JVM 联合 日 志 探 索 JPMS 

Java 9 引入 了 一 个 联合 日 志 架 构 ， 用 它 处 理 了 大 量 JVM 生成 的 信息 。 附 录 C 对 此 进行 了 介 
绍 ， 并 解释 了 配置 方法 。 如 果 你 之 前 没有 使 用 过 它 ， 那 么 建议 你 先 了 解 一 下 。 

了 解 了 日 志 机 制 及 其 配置 , 你 就 可 以 进一步 了 解 模 块 系统 的 工作 原理 了 。 下 面 的 例子 都 通过 
已 知 的 命令 启动 ServiceMonitor 应 用 程序 ， 并 使 用 - -ary-run 避免 其 真正 执行 。 


$ java 
--module-path mods:libs 
--dry-run 
--module monitor 


输出 片段 仅 展示 了 -xlog 配置 , 它 附加 在 上 面 的 命令 上 , 用 于 定义 输出 信息 。 为 了 减少 噪声 ， 
重点 ， 本 示例 移 除 了 所 有 标签 ， 并 进行 了 手动 编辑 。 真 实 的 日 志 中 包含 的 信息 远 不 止 于 此 。 
根据 附录 C 中 的 建议 查看 -Xlog:help, 看 见 了 module 标签 , 而 这 看 上 去 很 有 帮助 。 因 此 ， 
借助 mogulex 获 取 所 有 带 有 此 标签 的 日 志 。 


-Xlog:module* 
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突出 








此 处 省 略 了 很 多 模块 

java.base location: jrt:/java.base 
jdk.compiler location: jrt:/jdk.compiler 
spark.core location: file://... 
monitor.persistence location: file://... 
monitor.observer location: file://... 
monitor location: file://... 
monitor.rest location: file://... 

Phase2 initialization, 0.0977682 secs 


此 处 ,模块 系统 列 出 了 已 经 加 载 的 模块 ， 包 括 所 有 相关 的 平台 模块 和 monitor.* 模 块 及 其 依 
赖 。 现 在 ， 加 入 调试 信息 ， 查 看 更 多 细节 。 


# -Xlog:module*=debug 


VY NY WY YY 





# Argh! About 1500 lines of log messages 
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这 个 命令 的 输出 比较 多 , 但 是 仔细 查看 就 会 发 现 它 并 不 复杂 。 并 且 , 你 将 有 机 会 看 到 模块 系 
统 工作 中 的 一 些 细 节 。 所 以 来 浏览 一 下 吧 ! 

模块 系统 首先 处 理 的 是 无 名 模块 ， 这 很 有 趣 。 它 在 很 大 程度 上 仍然 非常 神秘 (参见 8.2 章 。 
然后 是 基础 模块 ， 如 3.1.4 节 所 述 ， 所 有 其 他 模块 都 依赖 于 它 ， 因 此 ， 早 早 定义 它 非常 正常 。 


> recording unnamed module for boot loader 
> java.base location: jrt:/java.base 
> Definition of module: java.base 


接 下 来 , 创建 所 有 可 见 模块 。 


> jdk.compiler location: jrt:/jdk.compiler 
creation of module: jdk.compiler 
jdk.localedata location: jrt:/jdk.localedata 
creation of module: jdk.localedata 
monitor.observer.alpha location: file://... 
creation of module: monitor.observer.alpha 


许多 其 他 模块 在 此 被 创建 
创建 了 所 有 模块 后 ， 模 块 系统 处 理 它们 的 描述 符 ， 根 据 定义 在 其 中 添加 可 读 性 边 和 包 导 出 。 


> Adding read from module java.xml to module java.base 
> package com/sun/org/apache/xpath/internal/functions in module java.xml 
> is exported to module java.xml.crypto 
package javax/xml/datatype in module java.xml 

is exported to all unnamed modules 
package org/w3c/dom in module java.xml 

is exported to all unnamed modules 
Adding read from module monitor.statistics to module monitor.observer 
Adding read from module monitor.statistics to module java.base 
package monitor/statistics in module monitor.statistics 

is exported to all unnamed modules 
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3 
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> 
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如 你 所 见 ， 它 用 “to module .…”( 向 模块 …… ) 这 样 的 措辞 来 描述 包 导 出 ， 并 且 有 时 它 的 值 
甚至 不 为 “all unnamed modules”( 所 有 无 名 模块 )。 这 是 为 什么 呢 ? 11.3 节 将 对 其 进行 讲解 ， 此 
时 你 仅 需 知道 包 导 出 得 到 了 处 理 即 可 。 

好 了 ， 最 后 一 条 信息 是 你 之 前 见 过 的 ， 它 在 演示 退出 前 显示 。 


> Phase2 initialization, 0.1048592 secs 


如 果 更 进一步 , 将 日 志 级 别 调整 为 trace, 那么 你 将 面 对 几 千 条 信息 , 但 是 其 中 没有 太 多 新 
的 内 容 。 你 仅 会 看 到 随 着 每 个 类 被 加 载 ， 模块 系统 记录 该 类 属于 哪个 包 、 哪 个 模块 ， 并 完成 对 包 
的 定义 ， 进 而 完成 相应 模块 的 创建 。 

如 果 去 除 --ary-run 选项 并 执行 应 用 程序 , 你 并 不 会 看 到 太 多 额外 的 信息 。 在 aebug 级 别 ， 
不 会 有 新 的 信息 ; 在 trace 级 别 ， 你 仅 会 看 到 一 些 骨 套 类 是 如 何 被 关联 到 已 有 的 包 中 的 。 
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注意 ”你 也 许 想 知道 这 些 是 否 都 发 生 在 一 个 单独 的 线程 中 ,答案 是 肯定 的 。 可 以 通过 用 
-Xlog:module*-=depug:stdout:tid 打印 线程 ID 来 验证 。 所 有 的 模块 及 相关 操作 都 
会 显示 同一 个 ID。 


现在 , 你 了 解 了 如 何 配 置 日 志 以 及 日 志 应 该 什么 样子 。 当 某 个 模块 化 应 用 程序 没有 按照 预期 
工作 ,并且 其 他 方法 无 法 给 出 有 效 的 分 析 时 ， 日 志 将 是 一 个 十 分 有 效 且 非 常 方 便 的 诊断 工具 。 


5.4 ”Java 虚拟 机 选项 


就 像 编译 器 和 归档 器 ， 虚 拟 机 通过 一 系列 新 的 命令 行 选项 来 与 模块 系统 交互 。 方 便 起 见 ,本 
节 把 它们 列 在 了 表 5-1 中 。 你 也 可 以 在 Oracle 的 网 页 上 查看 官方 文档 。 


























































































































表 5-1 按 字 母 顺序 排列 的 所 有 与 模块 相关 的 虚拟 机 (java 命令 ) 选项 。 以 下 描述 基于 官方 
文档 ， 引 用 指向 本 书 中 进行 详细 介绍 的 章节 
选 项 描 述 引 用 
--add-exports 使 模块 导出 额外 的 包 11.3.4 节 
--add-modules 定义 除 初始 模块 外 的 其 他 根 模块 3.4.3 节 
--add-opens 使 模块 开放 额外 的 包 12.2.2 节 
--add-reads 在 模块 间 添 加 可 读 边 3.4.4 节 
--describe-module、-d 显示 模块 名 、 依 赖 、 导 出 、 包 等 信息 5.3.1 节 
--dry-run 启动 虚拟 机 但 在 执行 main 函数 前 退出 5.3.3 节 
--illegal-access 指定 如 何 处 理 从 类 路 径 到 JDK 内 部 API 的 访问 7.1.4 节 
--1limit-modules 限定 可 见 模块 全 集 5.3.5 节 
--list-modules 列 出 所 有 可 见 模块 5.3.4 节 
--module、-m 指定 初始 模块 并 启动 它 的 主 类 5.1 节 
--module-path、-p 指定 搜索 应 用 程序 模块 的 位 置 3.4 节 
--patch-module 在 编译 过 程 中 用 类 扩展 已 有 模块 7.2.4 节 
--show-module-resolution 打印 模块 解析 的 信息 5.3.6 节 
--upgrade-module-path 指定 可 升级 模块 的 位 置 6.1.3 节 
--validate-modules 扫描 模块 路 径 中 的 错误 5.3.2 节 














除了 可 以 在 命令 行 中 使 用 这 些 选项 ， 你 也 可 以 在 可 执行 JAR 的 manifest 文件 中 指定 部 分 选 





项 ， 在 java 命令 读 取 的 某 个 环境 变量 中 定义 它们 , 或 者 将 它们 放 入 一 个 参数 文件 并 传递 给 正在 
启动 的 JVM。9.1.4 节 将 解释 以 上 所 有 方式 。 

现在 你 已 经 到 达 了 第 二 座 里 程 碑 以 及 第 一 部 分 的 结尾 , 掌握 了 模块 系统 的 基础 。 如 果 有 机 会 ， 
请 花 些 时 间 将 所 学 的 内 容 进 行 实践 一 一 创建 自己 的 演示 程序 ， 或 者 用 ServiceMonitor 做 些 实验 。 
接 下 来 学 习 哪 些 内 容 取 决 于 你 的 兴趣 。 如 果 你 有 想 迁 移 到 Java 9 及 以 上 版 本 的 项 目 , 并 且 有 兴 
将 其 模块 化 ， 请 阅读 第 二 部 分 ， 如 果 你 对 学 习 模 块 系统 的 其 他 特性 感 兴趣 ， 请 阅读 第 三 部 分 。 
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口 初始 模块 用 --module 定义 。 如 果 它 定义 了 主 类 ,就 可 以 直接 启动 应 用 程序 ; 否则 ,还 需 

要 在 模块 名 后 添加 一 个 完全 限定 类 名 ， 并 用 和 斜 杠 分 隔 。 

口 确保 在 -moqule 选项 前 列 出 所 有 JVM 选项 , 否则 它们 会 被 当 作 应 用 程序 参数 ,不 会 对 模 

块 系统 产生 作用 。 

口 可 见 模块 可 以 通过 --1ist-modules 列 出 。 当 你 需要 进行 调试 或 者 想 查 看 哪个 模块 可 以 

解析 时 ， 这 个 选项 会 非常 有 用 。 

口 如 果 使 用 了 --1imit-modules，, 那么 可 见 模块 全 集 只 包含 指定 的 模块 及 其 传递 依赖 ， 这 
可 以 缩小 解析 过 程 中 的 可 见 模块 的 范围 。 它 与 --1ist-modules 相 结 合 ， 可 以 很 好 地 检 
查 模块 的 传递 依赖 。 

口 --add-modules 选项 可 用 来 在 初始 模块 的 基础 上 定义 额外 的 根 模块 。 如 果 一 个 模块 没 
有 被 引用 ( 例如， 只 通过 反射 访问 )， 就 必须 借助 --adda-modqules 来 确保 它 出 现在 模块 
图 中 。 

口 使 用 --dry-run 选项 启动 JVM, 可 以 让 模块 系统 处 理 相 关 配 置 ( 模块 路 径 、 初 始 模块 等 ) 
并 构建 模块 图 , 但 是 在 调用 main 函数 前 退出 。 这 样 不 需要 启动 应 用 程序 就 可 以 对 配置 进 
行 验证 。 

口 模块 系统 通过 简单 的 --show-module-resolution 选项 或 是 更 加 复 林 的 -Xlog:module* 
选项 打印 各 种 日 志 信 息 。 它 们 可 以 帮助 分 析 模 块 系统 如 何 绘 制 模块 图 ， 进 而 帮助 人 们 进 
行 故障 排除 。 

口 从 模块 加 载 资源 和 从 JAR 加 载 资源 的 工作 机 制 非常 相似 ,但 是 这 里 有 两 个 例外 , 即 非 .class 
文件 的 资源 以 及 位 于 其 他 模块 的 包 中 的 资源 ( 相反 的 例子 是 JAR 的 根 目录 或 者 META-INF 
目录 )。 默 认 情 况 下 它们 是 被 封装 起 来 的 ， 因 此 无 法 访问 。 

口 借助 opens 指令 ， 模 块 可 以 让 包 通 过 反射 得 到 访问 ， 从 而 开放 其 中 的 资源 ， 人 允许 其 他 模 

块 加 载 它 们 。 遗 憾 的 是 ， 这 个 方案 会 使 其 他 代码 对 模块 的 内 部 结构 产生 依赖 。 

口 在 加 载 资 源 时 ,默认 使 用 Class 类 中 的 getResourc 和 getResourceAsStream 方法 ， 

或 使 用 新 的 java.1ang .Module 类 中 的 相应 方法 。classLoader 里 面 的 方法 已 经 不 再 

实用 。 




































































































































































改写 现实 世界 中 的 项 目 














本 书 第 一 部 分 探索 了 模块 系统 的 基础 ， 以 及 编译 、 打 包 和 运行 模块 化 应 用 程序 的 方法 。 除 讲 
述 相 关机 制 外 ， 还 展示 了 如 何 组 织 和 开发 未 来 的 Java 项 目 。 

但 是 现 有 项 目 呢 ? 你 一 定 想 让 它们 在 Java 9 或 更 高 的 版 本 中 运行 , 甚至 作为 模块 运行 。 第 二 
部 分 介绍 了 具体 的 实现 方式 。 
第 一 步 , 对 于 因 Java 8 生命 周期 结束 或 不 想 支付 技术 支持 费用 而 无 法 停留 在 Java8 上 的 代码 
库 而 言 , 在 Java 9 及 以 上 版 本 中 编译 和 运行 项 目 是 必须 的 。 而 第 二 步 , 将 项 目的 工件 转换 为 模块 
化 JAR 是 可 选 的 ， 并 且 可 以 慢 慢 实现 。 
第 6 章 和 第 7 章 专注 于 迁移 到 Java 9 的 话题 。 这 两 章 介 绍 如 何在 不 创建 任何 模块 的 情况 下 ， 
让 非 模块 化 、 基 于 类 路 径 的 项 目 在 最 新 的 Java 版 本 中 运行 。 接 下 来 ,第 8 章 介 绍 了 可 以 将 项 目 
增 量 模 块 化 的 一 些 特性 。 第 9 章 则 针对 如 何 利 用 第 6 章 到 第 8 章 的 知识 迁移 你 的 项 目 并 将 其 模块 
化 ， 提 供 了 一 些 战略 性 的 建议 。 

我 建议 按 顺 序 阅 读 这 些 章节 , 但 是 如 果 你 想 在 需要 时 再 学 习 技 术 细节 ，, 那么 可 以 从 第 9 章 开 
始 。 或 者 ， 你 也 可 以 先 阅读 最 有 可 能 遇 到 的 挑战 : 对 JEE 模块 的 依赖 (参见 6.1 节 ) 以 及 JDK 内 
部 实现 〈 人 参见 7.1 间 。 

这 一 部 分 没有 提供 具体 的 示例 。 代码 库 github.com/CodeFX-org/demo-java-9-migration 中 包含 
ServiceMonitor 应 用 程序 的 一 个 变 体 ， 要 使 它 在 Java 9 及 以 上 版 本 中 运行 ， 你 需要 解决 其 中 的 许 
多 问题 。 试 一 下 吧 





































































































迁移 到 Java 9 及 以 上 版 本 的 
兼容 性 挑战 








本 章 内 容 

口 为 什么 JEE 模块 被 弃 用 并 且 默 认 不 会 被 解析 

口 编译 和 运行 依赖 于 JEE 模块 的 代码 

口 为 什么 到 URLClassLoadqez 的 类 型 转换 会 失败 

口 理解 新 的 JDK 运行 时 镜像 布局 

口 蔡 换 已 被 删除 的 扩展 机 制 、 授 权 标准 履 盖 机 制 以 及 启动 类 路 径 选 项 























本 章 和 第 7 章 将 讨论 在 将 现 有 代码 库 迁 移 到 Java 9 及 以 上 版 本 时 要 面 对 的 兼容 性 挑战 。 这 两 
章 不 会 创建 任何 模块 ， 因 为 它们 讨论 的 是 在 最 新 的 Java 版 本 上 构建 和 运行 现 有 项 目 。 

为 什么 迁移 到 Java 9 及 以 上 版 本 需要 用 整整 两 章 来 讲述 ?难道 不 能 直接 安装 最 新 的 JDK 并 
且 期 望 一 切 照常 工作 吗 ? 难道 Java 不 能 向 后 兼容 吗 ? 能， 但 是 这 只 在 你 的 项 目 ( 及 其 依赖 ) 仅 
依赖 于 未 被 弃 用 的 、 标 准 化 的 、 文 档 化 的 行为 时 才 成 立 。 这 仅仅 是 一 种 假设 ,并 且 事 实 上 由 于 缺 
乏 强 制 性 ， 广 大 的 Java 社区 已 经 偏离 了 这 个 航向 。 

如 本 章 所 述 ， 模 块 系统 造成 了 Java 的 一 些 特性 被 弃 用 ， 另 一 些 特性 被 删除 ， 并 且 它 的 一 些 
内 部 实现 有 所 改变 。 
D 包含 JEEAPI 的 模块 被 弃 用 ， 并 且 需 要 手动 解析 依赖 (参见 6.1 欧 。 
口 应 用 程序 类 加 载 器 ( 也 称 系统 类 加 载 器 ) 不 再 是 URLClassLoader ， 这 破坏 了 一 些 强 甫 
类 型 转换 (参见 62 家 。 
口 Java 运行 时 镜像 ( JRE 和 JDK ) 的 目录 布局 进行 了 较 大 的 改造 (参见 63 欧 。 
口 一 系列 机 制 被 删除 ， 比 如 紧凑 型 配置 、 授 权 标准 覆盖 机 制 等 (参见 6.4 欧 。 
口 一 些 细节 也 被 改变 ， 比 如 不 再 将 单 下 划 线 作为 标识 符 (参见 65 区 。 

当然 ， 这 还 不 是 全 部 。 第 7 章 将 讨论 两 个 额外 的 挑战 〈 内 部 API 和 包 分 裂 )。 之 所 以 单独 用 
一 章 来 讨论 它们 ， 是 因为 在 完成 项 目 迁 移 后 ， 人 们 很 有 可 能 在 非 JDK 模块 中 再 次 遇 到 这 些 问 题 。 

综合 来 看 ， 这 些 挑战 影响 了 一 些 库 、 框 架 、 工 具 、 技 术 , 其 至 是 代码 。 所 以 非常 遗憾 ,升级 
到 Java9 及 以 上 版 本 并 不 总 是 个 简单 的 任务 。 总 的 来 说 , 项 目 越 大 、 越 老 ， 完 成 迁移 所 费 的 工夫 
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就 越 多 。 再 次 强调 ， 这 通常 非常 值得 花 时 间 ， 因 为 这 是 一 个 偿还 技术 债 , 将 代码 变 得 更 加 整洁 的 
绝 好 机 会 。 

完成 本 章 和 第 7 章 后 ， 你 将 了 解 升级 到 Java 9 、Java 10 、Java 11 甚至 更 高 版 本 的 挑战 。 针 对 
任何 一 个 应 用 程序 ,你 将 有 能 力 对 需要 完成 的 工作 进行 判断 ,并 可 以 在 所 有 依赖 都 就 位 的 情况 下 ， 
让 它 在 最 新 的 版 本 上 运行 。 你 也 将 为 第 9 章 做 好 准备 , 第 9 章 将 讨论 迁移 至 Java 9 及 以 上 版 本 的 
策略 。 


关于 类 路 径 

第 8 章 将 详细 讨论 如 何在 模块 化 JDK 上 运行 非 模块 化 代码 ， 现 在 你 仅 需 了 解 以 下 几 点 。 

口 类 路 径 的 工作 方式 不 变 。 在 迁移 到 Java9 及 以 上 版 本 的 过 程 中 , 你 将 继续 使 用 类 路 径 而 

不 是 模块 路 径 。 

口 即便 这 样 ， 模 块 系统 也 处 于 工作 状态 ， 例 如 进行 模块 解析 。 

口 因为 类 路 径 中 的 代码 会 自动 读 取 大 部 分 模块 (但 并 不 是 全 部 ， 参 见 6.1 节 )， 所 以 它们 
不 需要 任何 配置 就 在 编译 时 或 运行 时 可 用 。 





6.1 使 用 JEE 模块 


许多 Java SE 代码 与 Java EE/Jakarta EE ( 下文 将 两 者 缩写 为 JEE ) 相关 ， 我 们 立刻 能 想到 的 
有 CORBA 、jJava Architecture for XML Binding ( JAXB ) 和 Java API for XML Web Services 
(JAX-WS )。 并 ”API 与 其 他 API 属于 表 6-1 中 列 出 的 模块 。 很 遗憾 ， 这 并 不 是 一 个 简短 的 旁 注 
可 以 解释 清楚 的 。 当 你 试 着 编译 或 运行 一 些 代码 ， 而 这 些 代码 所 依赖 的 类 属于 这 些 模块 时 , 模块 
系统 会 报告 模块 图 中 缺失 这 些 模块 。 


表 6-1 6 个 JEE 模块 。 描 述 援引 自 官方 文档 




















模 块 名 描 述 包 
java.activation 定义 JavaBeans Activation Framework ( JAF ) API javax.activation 
java.corba 定义 Java 开放 管理 组 (OMG ) 绑 定 CORBA API 和 RMI-IIOPAPI javax.activity、 





javax.rmi、 
javax.rmi .CORBA、 


Org.omg.* 


java.transaction 定义 一 部 分 Java Transaction API ( JTA ) 以 支持 CORBA 互 操作 javax.transaction 
java.xml.bind 定义 JAXB API javax.xml .bind.* 
java.xml.ws 定义 JAX-WS 和 网 络 服务 元 数据 ( Web Services Metadata ) API javax. jws、 


javax.jws.soap、 
javax.xml .soap、 


javax.xml .ws .* 





























java.xml.ws.annotation ”定义 一 部 分 通用 注解 (Common Annotations ) API 以 支持 程序 运行 ”javax.annotation 
于 Java SE 平台 
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这 是 在 Java 9 中 对 某 个 类 进行 编译 时 所 遇 到 的 编译 错误 。 该 类 使 用 了 java.xml.bind 模块 中 的 
JAXBExceptiono 




















error: package javax.xml .bind is not visible 

import javax.xml .bind.JAXBException; 
(package javax.xml.bind is declared in module java.xml.bingd, 
which is not in the module graph) 


oe 
> 
Sw 
> 
> 
> 1 error 

















如 果 让 它 通 过 编译 却 忘 了 告知 运行 时 ， 你 将 得 到 NoclassDefFoundError。 














Exception in thread "main" java.lang.NoClassDefFoundError: 

javax/xml /bind/JAXBException 

at monitor.Main.main (Main.java:27) 

Caused by: ClassNotFoundException: 

javax.xml .bind.JAXBException 

at java.base/BuiltinClassLoader.loadClass 

(BuiltinClassLoader.java:582) 

at java.base/ClassLoaderssAppClassLoader.loadClass 
(ClassLoaders.java:185) 

java.base/ClassLoader.loadClass 
(ClassLoader.java:496) 

. 1 more 





a 


[a 


2 
> 
Se 
-a 
> 
> 
ps 


发 生 了 什么 ? 为 什么 标准 化 的 Java API 对 于 类 路 径 中 的 代码 不 可 用 ?如 何 解 决 这 个 问题 ? 


6.1.1 为 什么 JEE 模 块 很 特殊 


Java SE 包含 一 些 由 授权 标准 以 及 独立 技术 构成 的 包 。 这 些 技术 是 在 Java Community Process 
(JCP ) 之 外 开发 的 , 这 通常 是 因为 它们 依赖 于 由 其 他 组 织 监管 的 标准 。 相 关 的 例子 如 由 万 维 网 联 
盟 (W3C ) 和 Web Hypertext Application Technology Working Group ( WHATWG ) 开发 的 文档 对 
象 模 型 (DOM )， 以 及 Simple API for XML (SAX )。 

由 于 历史 原因 ，Java 运行 时 环境 (JRE ) 发 布 时 带 有 这 些 技术 的 实现 ， 但 是 用 户 可 以 在 JRE 
之 外 单独 升级 它们 。 这 可 以 通过 授权 标准 覆盖 机 制 (参见 6.5.3 节 ) 来 实现 。 

类 似 地 ， 应 用 程序 服务 器 经 常 通 过 提供 自己 的 实现 来 扩展 或 升级 CORBA 、JAXB 或 者 
JAX-WS API， 以 及 (java.activation 中 的 ) JAF 或 者 (java.transaction 中 的 ) JTA。 最 终 ，java.xml. 
ws.annotation 模块 包含 了 javax.annotation 包 。 它 经 常 被 不 同 的 JSR 305 实现 扩展 ， 后 者 因 
其 与 null 相关 的 注解 而 闻名 。 

在 上 述 对 随 Java 发 布 的 API 进行 扩展 或 替换 的 例子 中 ， 有 一 个 技巧 是 使 用 完全 相同 的 包 名 
或 类 名 ， 这 样 ， 这 些 类 就 会 从 外 部 JAR 而 非 内 建 的 JAR 中 加 载 。 用 模块 系统 的 术语 来 说 ， 这 叫 
作 包 分 裂 ， 即 同一 个 包 被 拆 分 到 不 同 的 模块 中 ， 或 者 拆 分 到 模块 和 类 路 径 中 。 
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包 分 裂 的 终结 
包 分 裂 在 Java 9 及 以 上 版 本 中 不 再 可 用 。7.2 节 将 讨论 相关 细节 ， 目 前 仅 需 了 解 在 类 路 径 
中 ， 随 Java 发 布 的 包 中 的 类 是 不 可 见 的 。 
口 如 果 Java 包含 了 一 个 具有 相同 完全 限定 名 的 类 ， 它 将 被 加 载 。 
口 如 果 该 包 的 Java 内 建 版 本 不 包含 所 需要 的 类 ， 那 么 不 论 该 类 是 否 存 在 于 类 路 径 中 ， 结 
果 都 会 是 编译 错误 或 者 刚刚 展示 的 NoClassDefFoundError。 








这 是 所 有 模块 中 所 有 包 的 通用 机 制 : 在 模块 和 类 路 径 之 间 将 它们 分 裂 会 让 类 路 径 部 分 不 可 见 。 
与 其 他 模块 不 同 ， 这 6 个 JEE 模块 的 独特 之 处 是 ， 它 们 通常 使 用 包 分 裂 的 方式 进行 扩展 或 升级 。 

为 了 让 应 用 程序 服务 器 和 类 似 JSR 305 实现 的 库 在 不 需要 大 量 配置 的 情况 下 继续 工作 ， 人 们 
不 得 不 妥协 : 针对 类 路 径 中 的 代码 ，Java 9 和 Java 10 默认 不 会 解析 JEE 模 块 ， 这 意味 着 它们 不 
会 被 放 入 模块 图 ， 因 此 这 些 JEE 模块 是 不 可 用 的 (未 解析 模块 参见 3.4.3 节 、 类 路 径 场景 的 细节 
参见 8.22 欧 。 

这 在 自身 实现 了 JEE API 的 应 用 程序 中 效果 很 好 ， 但 在 依靠 JDK 内 建 版 本 的 应 用 程序 中 不 
怎么 样 。 在 不 做 进一步 配置 的 情况 下 ,类 路 径 中 的 代码 如 果 使 用 了 那 6 个 JEE 模块 所 提供 的 类 型 ， 
将 无 法 编译 和 运行 。 

为 了 解决 这 个 难题 ， 并 且 恰 当地 将 Java SE 和 JEE 分 开 ，Java 9 弃 用 了 这 些 模块 ，Java 11 则 
删除 了 它们 。 随 着 它们 的 删除 ， 像 wsgen 和 xjc 这 样 的 命令 行 工 具 也 不 再 同 JDK 一 起 发 布 。 


6.1.2 人工 解析 JEE 模 块 


当 由 于 缺少 JEEAPI 而 遇 到 编译 时 或 运行 时 错误 ， 或 者 JDeps 分 析 〈 人 参见 附录 D ) 显示 应 用 
程序 依赖 于 JEE 模 块 时 ， 该 怎么 办 ? 可 以 采用 以 下 3 种 方法 。 
口 如 果 你 的 应 用 程序 在 应 用 程序 服务 器 中 运行 ， 它 会 提供 这 些 API 的 实现 ， 此 时 你 应 该 不 
会 遇 到 运行 时 错误 。 这 与 设置 有 关 ， 你 也 许 需要 修复 构建 错误 一 一 虽然 另外 两 个 方案 也 
需 如 此 。 
口 选择 相关 API 的 第 三 方 实现 ， 将 其 作为 依赖 添加 到 项 目 中 。 由 于 JEE 模块 在 默认 情况 下 
不 会 得 到 解析 ， 因 此 编译 时 和 运行 时 可 以 正常 使 用 这 些 第 三 方 实现 。 
口 在 Java 9 和 Java 10 中 , 用 --ada-modules 选项 添加 平台 模块 (参见 3.4.3 节 )。 因 为 
Java 11 删除 了 JEE 模块 ， 所 以 这 个 办 法 不 适用 于 Java 11。 
本 节 最 开始 的 例子 尝试 使 用 java.xml.bind 模块 中 的 JAXBException。 下 面 展示 了 如 何 通过 
--add-modules 选项 让 这 个 模块 对 编译 可 用 。 
$ javac 
--Cclass-path ${jars} 
--add-modules java.xml .bingd 


-Q $s{output-dir} 
$s{source-files} 
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代码 完成 编译 和 打包 后 ， 为 方便 执行 ， 你 需要 再 次 添加 这 个 模块 。 


S java 
--class-path S${jars} 
--add-modules java.xml .bind 
s{main-class} 


如 果 依 赖 于 一 些 JEE API， 添 加 java.se.ee 模块 会 比 逐 个 添加 单个 模块 简单 一 些 。 它 让 所 有 6 
个 JEE 模块 全 部 可 用 ， 将 事情 简化 。( 它 是 如 何 让 这 些 模块 可 用 的 ? 可 以 参见 11.1.5 节 ) 

















要 点 ”建议 你 认真 考虑 将 必要 API 的 第 三 方 实现 添加 为 项 目的 常规 依赖 ， 以 替代 
--add-modules。9.1.4 节 将 讨论 使 用 命令 行 选项 的 缺点 ， 所 以 在 沿 着 这 条 路 继 
续 向 前 之 前 ， 请 先 阅读 这 一 节 。 同 时 ， 由 于 Java 11 删除 了 JEE 模块 ， 因 此 你 早 
晚会 需要 一 个 第 三 方 实现 。 

只 有 非 模块 化 代码 才 需 要 人 工 添加 JEE 模块 。 一旦 代码 被 模块 化 ，JEE 模块 就 不 再 特别 : 你 


可 以 像 对 待 任何 其 他 模块 一 样 对 它们 进行 依赖 ,它们 也 会 像 其 他 模块 一 样 被 解析 , 至 少 在 被 删除 
之 前 是 这 样 。 





第 三 方 JEE 实现 
比较 和 讨论 各 个 JEE API 的 第 三 方 实现 会 过 度 偏 离 模块 系统 这 一 主题 , 所 以 本 书 不 会 这 样 
做 。 但 是 ，JEP 320 和 Stack Overflow 的 官方 网 站 列 出 了 一 些 选项 。 


6.1.3 ”JEE 模 块 的 第 三 方 实现 


也 许 你 一 直 在 使 用 授权 标准 覆盖 机 制 来 更 新 标准 和 独立 技术 ,你 也 许 会 好 奇 ,在 使 用 模块 后 ， 
这 个 机 制 发 生 了 什么 变化 。 正 如 你 可 能 已 经 猜 到 的 ， 它 被 删除 了 并 被 新 事物 取代 。 
译 器 和 运行 时 都 提供 --upgrade-module-path 选项 ， 用 于 接受 一 个 目录 列表 。 该 目录 
列表 的 格式 与 模块 路 径 的 参数 相同 。 模块 系统 在 创建 模块 图 时 , 会 在 这 些 目录 中 查找 工件 并 用 它 
们 替换 可 升级 模块 。6 个 JEE 模块 永远 可 以 升级 。 


口 java.activation 











区 

















口 java.corba 
口 java.transaction 
口 java.xml.bind 


口 java.xml.ws 





口 java.xml.ws.annotation 

JDK 的 供应 商会 使 更 多 模块 可 升级 。 例 如 在 Oracle JDK 上 ，java.jnlp 模块 就 是 如 此 。 此 外 ， 
通过 jlink 链接 到 模块 图 的 应 用 程序 模块 也 始终 是 可 升级 的 〈 详细 信息 参见 14.2.1 前 。 

在 升级 模块 路 径 上 ，JAR 不 必 是 模块 化 的 。 如 果 缺 少 模块 描述 符 ， 它 们 将 被 转换 为 自动 模块 
(参见 8.3 节 )， 并 且 仍 然 可 以 替换 Java 模块 。 
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6.2 转化 为 URLClassLoader 


在 Java9 或 更 高 版 本 上 运行 项 目 时 ， 可 能 会 遇 到 类 似 下 面 示例 的 类 转换 异常 。 示 例 中 , JVM 
抱怨 无 法 将 jdk.internal.loader.ClassLoaders.AppClassLoader 的 实 例 转 化 为 
URLClassLoader。 


> Exception in thread "main" java.lang.ClassCastException: 


> > java.base/jdk.internal.loader.ClassLoaderss$sAppClassLoader 
人 cannot be cast to java.base/java.net.URLClassLoader < 
> at monitor.Main.getClassPathContent (Main.java:46) 
> at monitor.Main.main (Main.java:28) 
getclass 返回 的 类 加 载 器 AppClassLoader 不 扩展 URLClassLoader， 
是 一 个 AppclassLoader 因此 类 型 转换 失败 




















上 述 新 类 型 是 什么 ? 为 什么 代码 无 法 运行 9 下 面 找 找 原因 。 在 此 过 程 中 , 你 将 了 解 Java 9 如 
何 通过 改变 类 加 载 行为 提高 启动 性 能 。 因 此 ,即使 你 在 项 目 中 没有 遇 到 此 类 问题 ， 它 仍然 是 你 强 
化 Java 知识 的 绝 佳 机 会 。 


6.2.1 应 用 程序 类 加 载 器 的 变化 


在 所 有 Java 版 本 中 ， 应 用 程序 类 加 载 器 ( 通常 称 为 系统 类 加 载 器 ) 是 JVM 用 于 运行 应 用 程 
序 的 三 个 类 加 载 器 之 一 。 它 加 载 不 需要 任何 特殊 权限 的 JDK 类 以 及 所 有 应 用 程序 类 ( 除非 应 用 
程序 使 用 自己 的 类 加 载 器 ， 在 这 种 情况 下 ， 本 节 所 述 内 容 都 不 适用 )。 

可 以 调用 ClassLoader.getSystemClassLoader() 或 者 在 基 个 类 的 实 例 上 调用 
getclass().getclassLoader () 方 法 ， 访 问 应 用 程序 类 加 载 器 。 这 两 种 方法 都 承诺 返回 
ClassLoader 类 型 的 实例 。 在 Java 8 及 之 前 的 版 本 中 ， 应 用 程序 类 加 载 器 是 URLClassLoader 
类 型 ， 它 是 classLoader 的 一 个 子 类 型 。 因 为 URLC1assLoader 提供 了 一 些 方便 的 方法 ， 所 
以 人 们 通常 将 实例 转化 为 这 个 类 。 可 以 参考 代码 清单 6-1 中 的 例子 。 


代码 清单 6-1 将 应 用 程序 类 加 载 絮 转化 为 URLC1assLoader 


获得 应 用 程序 类 加 载 器 并 将 其 
private String getClassPathContent() { 转化 为 URLC1assLoader 
URLClassLoader loader = 
(URLClassLoader) this.getClass() .getClassLoader(); 


return Arrays.stream(loader.getURLs()) 
.map (URL: : toString) ClassLoader 中 不 存在 getURLs 方法 ， 


TT ne ey 这 就 是 要 进行 类 型 转换 的 原因 












































} 

如 果 没 有 模块 作为 JAR 的 运行 时 呈现 ，URLC1assLoader 就 无 法 知道 要 从 哪个 工件 中 找到 
站 定 的 类 。 因 此 ,一 旦 需要 加 载 某 个 类 ，URLC1l1assLoader 就 会 扫描 类 路 径 上 的 每 个 工件 ， 直 
到 找到 目标 为 止 (如 图 6-1 所 示 )。 这 显然 非常 低 效 。 
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加 载 org .conpany .Thing JVM 扫 描 模 块 路 径 上 的 
ee 所 有 JAR……: 


i 直到 找到 包含 所 需 
/se 










JPMS 构 建 了 一 个 从 包 到 
上 | 模块 的 映射 …… 


加 载 org .Company .Thing 


a 然后 直接 从 该 类 所 在 


国 国 国 国 
国 图 国 国 国 Ee 


图 6-1 没有 模块 时 ( 上 )， 需 扫描 类 路 径 上 的 所 有 工件 以 加 载 指 定 的 类 。 有 了 模块 后 ( 下 )， 
类 加 载 器 知道 包 来 自 哪个 模块 化 JAR 并 直接 从 那里 加 载 它 


现在 转向 Java 9 及 以 上 版 本 。 由 于 有 了 JAR 在 运行 时 的 正确 呈现 ， 类 加 载 的 行为 得 到 了 改 
进 : 当 需 要 加 载 某 个 类 时 ， 会 标识 它 所 属 的 包 ， 用 于 确定 从 哪个 特定 的 模块 化 JAR 中 加 载 。 于 
是 只 需要 扫描 该 JAR 就 可 以 找到 所 需 的 类 (如 图 6-1 所 示 )。 这 基于 一 条 假设 : 没有 两 个 模块 化 
JAR 在 同名 包 中 含有 相同 的 类 型 。 如 果 该 假设 不 成 立 ， 就 会 出 现 包 分 裂 问题 , 这 在 模块 系统 下 会 
引发 错误 ， 如 7.2 节 所 述 。 

新 的 类 型 AppclassLoader 及 其 等 同 的 新 超 类 BuiltinclassLoader 实现 了 新 的 行 
为 。 从 Java 9 开始 ， 应 用 程序 类 加 载 器 变 成 了 AppclassLoader。 这 意味 着 已 很 少 使 用 的 
(URLClassLoader) getClass() .getclassLoagder () 语 句 将 不 能 再 继续 工作 。 如 果 想 了 解 
Java 9 及 以 上 版 本 中 关于 类 加 载 器 的 结构 和 关系 的 更 多 信息 ， 可 以 参见 12.4.1 节 。 








6.2.2 不 再 通过 URLCl1assLoader 来 获得 类 加 载 器 


如 果 你 在 依赖 的 项 目 中 遇 到 URLC1assLoader 的 类 型 转换 ， 并 且 该 项 目 无 法 更 新 到 Java 9 
及 以 上 的 兼容 版 本 ， 那 么 只 能 采取 以 下 方法 之 一 进行 应 对 。 
口 向 该 项 目 报告 问题 ， 或 者 提交 修复 代码 。 
口 在 本 地 自行 建立 项 目 克隆 或 项 目 补 丁 。 
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口 等 待 。 

如 果 该 问题 无 法 得 到 解决 ， 你 或 许可 以 切换 到 另 一 个 支持 Java 9 及 以 上 版 本 的 库 或 框架 。 

如 果 是 自己 的 代码 进行 了 这 样 的 类 型 转换 ， 你 可 以 ( 也 必须 ) 采取 一 些 措施 。 遗 憾 的 是 ， 你 
可 能 不 得 不 放弃 一 两 个 功能 ， 因 为 在 将 类 型 转换 为 URLC1assLoader 时 ， 代 码 可 能 使 用 了 它 的 一 
些 特定 API。 尽管 classLoader 中 已 经 添加 了 一 些 API, 但 它 尚 无 法 完全 取代 URLCl1assLoader。 
不 过 ， 请 先 静观 其 变 ， 它 的 效果 也 许 能 满足 你 的 要 求 。 

如 果 你 只 需要 查看 应 用 程序 启动 的 类 路 径 ， 那么 请 检查 系统 属性 java.class.path。 如 果 
你 已 经 使 用 URLClassLoader 通过 在 类 路 径 中 指定 JAR 的 方式 来 动态 加 载 用 户 提供 的 代码 
( 例如 ， 作 为 插件 基础 结构 的 一 部 分 )， 那 么 你 必须 找到 一 种 新 方法 来 完成 这 样 的 操作 ， 因 为 使 
用 Java 9 及 以 上 版 本 中 的 应 用 程序 类 加 载 器 是 无 法 完成 这 一 任务 的 。 

相反 ,考虑 创建 一 个 新 的 类 加 载 器 。 它 具有 额外 的 优势 ， 你 将 得 以 摆脱 那些 新 的 类 ， 因 为 它 
们 没有 被 加 载 到 应 用 程序 类 加 载 器 中 。 如 果 你 至 少 需要 基于 Java 9 进行 编译 ,那么 “ 层 ” 可 能 是 
更 好 的 解决 方案 (参见 12.4 欧 。 

你 或 许 很 想 了 解 AbpclassLoader， 以 探寻 是 否 能 够 利用 它 的 功能 来 满足 需要 。 总 的 来 说 ， 
这 是 不 需要 的 ! 依赖 于 AppclassLoader 会 显得 非常 丑陋 ， 因 为 它 是 一 个 私有 的 内 部 类 ， 所 以 
不 得 不 使 用 反射 来 调用 它 。 同 时 ， 本 书 也 不 推荐 依赖 其 公有 的 超 类 BuiltinclassLoader。 

正如 包 名 jdk.internal.1loader 所 上 暗示 的 那样 ， 它 是 一 个 内 部 API。 而 且 由 于 该 软件 包 
是 Java 9 新 增 的 ， 在 默认 情况 下 不 可 用 ， 因 此 必须 借助 --add-exports 其 至 --add-opens 才 
能 使 用 它 〈 详细 信息 参见 7.1 节 )。 但 是 这 样 不 仅 会 使 代码 和 构建 过 程 变 得 复杂 ， 而 且 在 未 来 的 
Java 更 新 中 还 可 能 导致 兼容 性 问题 ( 比如 ， 当 这 些 类 被 重 构 时 )。 所 以 ， 除 非 绝 对 有 必要 实现 关 
键 任务 功能 ， 否 则 请 不 要 这 样 做 。 


6.2.3 ”寻找 制造 麻烦 的 强制 类 型 转换 


检查 这 些 强制 类 型 转换 的 代码 很 简单 : 对 (URLClassLoader) 进行 全 文 搜索 即 可 ( 此 处 括号 
用 于 查找 是 否 为 强制 类 型 转换 )。 该 方法 几乎 没有 误 报 。 至 于 在 依赖 项 中 执行 查找 ， 目 前 还 没有 
找到 合适 的 工具 。 将 特殊 的 构建 工具 〈 在 同一 个 地 方 获取 所 有 依赖 项 的 源 JAR )、 特 殊 的 命令 行 
工具 〈 访 问 所 有 的 .java 文件 及 其 文件 内 容 ) 和 全 文 搜索 相 结合 ， 也 许可 以 做 到 这 一 点 。 


6.3 ”更 新 后 的 运行 时 镜像 目录 布局 


在 20 多 年 的 时 间 里 ，JDK 和 JRE 的 目录 结构 逐渐 发 展 ， 该 过 程 中 虽然 产生 了 一 些 瑕 病 , 但 
这 不 足 为 奇 。 当 然 , 不 重新 组 织 它 们 的 一 个 原因 在 于 向 后 兼容 性 。 对 于 每 一 个 细节 而 言 ， 一 些 代 
码 的 确 取决 于 具体 布局 ， 如 以 下 两 个 例子 所 示 。 

口 某 些 工具 ， 特 别 是 IDE， 依 赖 于 rt .jar (构成 核心 Java 运行 时 的 类 )、tools .jar ( 工 
具 和 实用 程序 的 支持 类 ) 和 src.zip (JDK 源 代码 ) 的 准确 位 置 。 
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口 有 一 些 代码 通过 推测 正在 运行 的 JRE 带 有 一 个 同 级 目录 bin， 而 在 里 面 搜 索 javac、jar 
或 javadoc 等 Java 命令 ， 但 是 只 有 当 JRE 是 JDK 安装 中 的 一 部 分 时 ， 这 么 做 才 正 确 ， 
因为 包含 这 些 命令 的 bin 目录 在 这 种 情况 下 与 jre 目录 是 相 邻 的 。 

但 是 模块 系统 的 出 现 打破 了 这 两 个 例子 的 基本 假设 。 

口 JDK 代码 现在 已 经 模块 化 ， 因 此 它 应 该 由 单个 模块 ,而 不 是 像 rt .jar 和 tools.jar 这 

样 的 JAR 提供 。 

口 借助 模块 化 的 Java 代码 库 和 jlink 等 工具 ， 可 以 将 任何 模块 集 创 建 为 运行 时 镜像 。 

从 Java 11 开始 ,不 再 有 独立 的 JRE 包 ， 因 此 运行 程序 需要 JDK 或 者 由 jlink 创建 的 包 。 
很 明显 , 模块 系统 会 引起 一 系列 重大 改变 。 于 是 为 了 一 以 贯 之 , 需要 彻底 重新 组 织 运 行 时 镜 

像 目 录 结 构 。 图 6-2 展示 了 相应 的 结果 。 总 体 而 言 ， 新 的 布局 更 为 简单 。 

口 单个 bin 目录 ， 并 且 没 有 重复 的 二 进 制 可 执行 文件 。 

口 单个 lib 目录 。 

口 单个 conf 目录 ， 包 含 用 于 配置 的 所 有 文件 。 






















































. 包含 二 进 制 可 执行 配置 文件 ， 比 如 .properties、 
Oracle 二 | 分 布 式 Apache Derby 文件 ， 比 如 java、 policy 和 其 他 类 型 ， 以 前 
开 洒 数 据 计 (在 Java 9 中 已 删除 ， 加 jdk-8 javac、jar 和 jdeps 辑 jdk-9 它们 分 散 地 放 在 不 同 的 目 
参 录 中 
国 bin 国 bin LA 
C 语 言 头 文件 ， 
C 语 言 头 文件 ， 加 中 (ERE 中 不 有 在 、、、、 名 conf 原始 的 平台 模块 呈现 
在 JRE 中 下 存在 一 >* 国 incude [ wp 为 jmod 文 件 ， 它 们 的 
1 运行 时 环境 (rt.jar) 、 1 代码 之 前 存放 在 rt .jar、 
JDK 8 中 包含 的 运行 一 一 名 je 有 本 地 依赖 库 〔 即 .dl 或 国 jmods tools .jar 和 其 他 JAR 中 ， 
时 环境 位 于 一个 子 国 on so 文件 ) 、 配 置 文人 国 legal 在 了 RE 中 不 存在 
日 中 图 (比如 .properties 文 件 ) 、 国 
- policy 文 件 以 及 其 他 各 种 文件 
国 plugin README.html, release 
开发 依赖 库 (比如 tools .jar COPYRIGHT, LICENSE, README ... 
和 at .jar) 以 及 工具 (VisualVM. 一 >> lib 平台 模块 融合 到 模块 文件 中 ， 
MissionControl ) 劝 本 地 库 〈.dl 或 so) 和 其 他 文件 
man (.properties、.policy) 以 前 在 
JDK 工 具 的 文档 COPYRIGHT LICENSE, README.html, release .， lib 和 jrelib 中 。 还 有 MissionControl， 
对 于 VisualVM， 可 以 参见 6.$.2 节 


src.zip, javafx-src.zip 











图 6-2 JDK 8 和 JDK 9 的 目录 结构 比较 ,新 版 本 的 目录 更 加 清晰 








这 些 改变 带 来 的 最 直接 影响 是 , 你 需要 更 新 开发 工具 ,因为 旧版 本 可 能 不 适用 于 JDK9 及 以 
上 版 本 。 在 这 种 情况 下 ， 根 据 项 目的 不 同 ， 对 于 在 JDK/JRE 目录 中 检索 二 进 制 文件 、 属 性 文件 
等 的 代码 来 说 ， 搜 索 新 版 本 并 进行 升级 可 能 非常 有 意义 。 
用 于 获取 系统 资源 的 URL (例如 classLoader: :getSystemResource ) 也 已 经 发 生变 化 。 
它 曾 经 是 以 下 形式 : 


jar:file:${java-home}/lib/rt.jar!s{path} 














其 中 ，s {path} 是 类 似 于 java/1ang/string.class 的 内 容 。 它 现在 变 成 了 : 
jrt:/s{module}/s{path} 


创建 或 使 用 这 类 URL 的 所 有 JDK 接口 都 在 新 模式 上 运行 ,但 是 对 于 手动 处 理 这 些 URL 的 








6.4 选择、 替换 和 扩展 平台 121 





非 JDK 代码 而 言 ， 需 要 进行 更 新 以 支持 Java 9 及 以 上 版 本 。 

此 外 ，cClass::getResource* 和 ClassLoader::getResource* 方 法 不 再 读 取 JDK 内 部 
资源 。 相 反 ， 要 访问 模块 的 内 部 资源 ， 请 使 用 Module: :getResourceAsStream 或 创建 一 个 
JRT 文件 系统 ， 如 下 所 示 。 


FileSystem fs = FileSystems.getFileSystem(URI.create("jrt:/")); 
fs.getPath("java.base", "java/lang/Sstring.class")); 


关于 如 何 访问 资源 的 更 多 信息 ， 可 以 参见 5.2 节 。 


6.4 选择、 替换 和 扩展 平台 


在 编译 代码 或 启动 JVM 时 ， 曾 经 有 各 种 方法 来 指定 由 哪些 类 构成 JD 开 平台 。 可 以 选择 JDK 
的 一 个 子 集 ， 将 特定 技术 ( 比如 JAXB ) 替换 为 另 一 个 ， 添 加 几 个 类 ， 或 者 选择 一 个 完全 不 同 的 
平台 版 本 来 执行 编译 或 启动 。 模 块 系统 导致 其 中 一 些 功 能 过 时 了 , 同时 以 更 现代 的 方式 重新 实现 
了 另外 一 些 功能 。 并 且 ， 即 使 不 考虑 JPMS，Java 9 也 抛弃 了 一 些 旧 的 内 容 。 

如 果 你 依赖 于 本 节 中 讨论 的 一 个 或 多 个 特性 ， 那 么 必须 采取 一 些 措施 ， 保 证 项 目 正 常 运 行 。 
没有 人 愿意 对 不 会 引起 明显 问题 的 工作 返工 ,但 是 看 看 这 些 特性 ( 大 部 分 我 没有 使 用 过 )， 我 只 
能 想象 在 没有 它们 的 情况 下 ，JDK 内 部 结构 会 变 得 多 么 简单 。 


6.4.1 不 再 支持 紧凑 配置 


正如 1.6.5 节 所 述 , 模块 系统 的 一 个 目标 是 ,使 用 户 能 够 创建 仅 包 含 所 需 模块 的 运行 时 镜像 。 
对 于 存储 有 限 的 小 型 设备 和 虚拟 化 环境 来 说 , 这 一 点 非常 重要 ,因为 两 者 都 非常 关心 运行 时 镜像 
的 大 小 。 当 确定 模块 系统 不 会 随 Java 8 发 布 时 ( 曾经 计划 在 Java 8 中 发 布 模块 系统 )， 紧 凑 配 置 
作为 临时 解决 方案 诞生 了 。 

JavaSE8API 和 JRE 的 3 个 紧凑 配置 仅 包 含 支持 这 些 API 子 集 所 需 的 类 。 在 选取 与 应 用 程序 
需求 相 匹配 的 配置 后 ， 使 用 javac 选项 -profile 进行 编译 (以 确保 所 选 子 集 正确 )， 然 后 运行 
相应 的 字 节 码 。 

在 模块 系统 中 , 由 于 可 以 使 用 jlink 创建 更 灵活 的 运行 时 镜像 (参见 14.1 节 ), 不 再 需要 紧 
凑 配 置 ， 因 此 Java9 及 以 上 版 本 仅 在 编译 Java 8 时 接受 -profile 选项 。 要 根据 选择 的 模块 进行 
编译 ， 可 以 使 用 5.3.5 节 所 述 的 --1imit-modules 选项 。 

以 下 是 获取 与 3 个 紧凑 配置 相同 的 API 所 需 的 模块 。 

口 compact1 配置 
口 compact2 配置 一 一 compactl 中 的 模块 加 上 java.rmi、java.sql 和 java.xml。 

口 compact3 配置 一 一 compact2 中 的 模块 加 上 java.compiler、java.instrument、java.manage- 
















































































































































































java.base 、java.logging 和 java.scripting。 





ment 、java.naming 、java.prefs 、java.security.jgss 、java.security.sasl 、java.sql.rowset 和 


Java.xml.crypto。 
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相 较 于 依赖 固定 的 选择 ， 本 书 推荐 不 同 的 方法 。 使 用 jlink 创建 仅 包 含 所 需 平 台 模 块 的 镜 
像 (参见 14.1 节 )。 如 果 应 用 程序 及 其 依赖 是 完全 模块 化 的 ， 甚 至 可 以 包括 应 用 程序 模块 (参见 
14.2 区 。 


6.4.2 ”扩展 机 制 被 移 除 


Java9 之 前 的 扩展 机 制 使 人 们 可 以 向 JDK 中 添加 类 , 而 无 须 将 它们 放 在 类 路 径 上 。 扩展 机 制 
可 以 从 各 种 目录 加 载 类 : 系统 属性 java .ext .dirs 指定 的 目录 、JRE 中 的 lib/ext 目录 ,或 特定 
于 平台 的 系统 目录 。Java9 移 除了 此 功能 ， 如 果 JRE 目录 存在 或 系统 属性 已 设置 ， 编 译 时 和 运行 
时 将 退出 并 提示 错误 信息 。 

替代 方案 如 下 : 

口 java 和 javac 选项 --patch-module 将 内 容 注 入 模块 (参见 7.2.4 和 区 ; 

口 java 和 javac 选项 --upgrade-module-path 将 可 升级 的 平台 模块 蔡 换 为 另 一 个 平台 
模块 (参见 6.1.3 前 ; 

口 扩展 工件 可 以 放置 在 类 路 径 上 。 


6.4.3 ”授权 标准 覆盖 机 制 被 移 除 


Java 9 之 前 ， 授 权 标 准 覆 盖 机 制 使 得 人 们 可 以 用 自 定 义 实 现 蔡 换 某 些 API。 它 从 系统 属性 
java.endorsed.dirs 指定 的 上 日 录 或 JRE 中 的 lib/endorsed 目录 中 加 载 类 。Java 9 移 除 了 此 功 
如 果 JRE 目录 存在 或 系统 属性 已 设置 , 编译 涡 和 运行 时 将 退出 , 并 提示 错误 信息 。 它 的 替代 方案 
与 扩展 机 制 相同 (参见 6.4.2 芍 。 


6.4.4 ” 某 些 启动 类 路 径 选 项 被 移 除 


移 除 了 -Xbootclasspath 和 -Xbootclasspath/p 选项 ， 使 用 如 下 替代 选项 : 
口 javac 选项 --systenm 指定 系统 模块 的 可 选 路 径 ; 

口 javac 选项 --release 指定 可 选 平台 的 版 本 ; 

口 java 和 javac 选项 --patch-module 将 内 容 注 入 初始 模块 图 中 的 模块 中 。 








































































































6.4.5 不 支持 Java 5 编译 


Java 编译 器 可 以 处 理 来 自 各 种 Java 版 本 ( 例如 使 用 -source 指定 的 Java 7 ) 的 源 代码 ， 并 
且 可 以 为 各 种 JVM 版 本 ( 例如 使 用 -target 指定 Java 8 ) 生成 字 节 码 。Java 过 去 遵循 “1+3” 版 
本 策略 ， 意 味 着 javac 9 支持 Java9 以 及 Java 8、Java 7 和 Java 6 版 本 。 

在 javac 8 上 设置 -source 5 或 -target 5 会 产生 “已 废弃 ”警告 ，javac 9 也 不 再 支持 
这 样 做 。 在 Java 9 上 设置 -source 6 或 -target 6 会 导致 相同 的 警告 。 现 在 ， 因 为 Java 每 6 个 
月 发 布 一 次 ， 所 以 此 策略 已 不 再 适用 。Java 10 、Java 11 和 Java 12 也 可 以 编译 Java 6 的 代码 。 
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注意 ”编译 器 可 以 识别 和 处 理 以 前 所 有 JDK 的 字 节 码 ， 只 是 不 再 生成 Java 6 之 前 的 字 
节 码 。 


6.4.6 JRE 版 本 选择 被 移 除 


在 Java9 之前， 人 们 可 以 使 用 java 的 -version:N 选项 (或 相应 的 清单 条 目 ) 来 启动 采用 
版 本 为 的 JRE 的 应 用 程序 。 在 Java9 中 ,该 功能 被 移 除 了 : 如 果 在 命令 行 中 指定 该 选项 ，Java 
启动 器 会 提示 错误 信息 , 并 退出 ; 如 果 在 manifest 条 目 中 指定 该 选项 , Java 启动 器 则 会 打印 警告 ， 
并 且 忽 略 该 选项 。 如 果 你 一 直 依赖 该 功能 ， 下 面 是 Java 文档 对 此 提出 的 建议 。 
































现代 应 用 程序 通常 通过 Java Web Start ( JNLP )、 操 作 系 统 的 打包 系统 或 安装 程序 进 
行 部 署 。 这 些 技术 有 自己 管理 所 需 JRE 的 方法 , 可 以 根据 需要 查找 、 下 载 或 更 新 对 应 的 
JRE。 这 使 得 启动 器 的 启动 时 JRE 版 本 选择 被 废弃 。 


文档 认为 使 用 -version:N 的 应 用 程序 不 够 现代 一 一 这 个 说 法 太 粗鲁 了 。 顺便 说 一 句 ， 如 果 
你 的 应 用 程序 依赖 于 该 功能 , 除了 放弃 它 别 无 选择 。 可 采用 的 手段 包括 将 其 与 最 合适 的 JRE 捆绑 
在 一 起 。 


6.5 一 着 不 慎 ， 满 盘 皆 输 


除 模块 系统 带 来 的 较 大 挑战 外 , 还 有 一 些 较 小 的 更 改 (通常 与 JPMS 无 关 ) 同样 会 造成 麻烦 。 
口 版 本 字符 串 的 新 格式 。 
口 移 除 多 个 JDK 和 耻 E 工 具 。 
口 单个 下 划 线 不 再 是 有 效 的 标识 符 。 
口 更 新 Java 网 络 启动 协议 (JNLP ) 的 语法 。 
口 删除 JVM 选项 。 
尽管 本 书 不 想 在 这 里 花费 太 多 时 间 , 但 也 不 想 留 下 一 些 妨碍 人 们 进行 迁移 的 陷阱 。 因 此 , 本 
书 将 对 每 一 条 进行 简要 解释 。 


6.5.1 新 的 版 本 字符 串 
在 历经 20 多 年 之 后 ，Java 终于 正式 停止 采用 1.x 进行 版 本 命名 。 从 此 ， 系 统 属性 java 


version、 java.runtime.version、 java.vm.version,、 java.specification.version 
和 java.vm.specification.version 不 再 以 1.x 开 头 , 而 是 以 xz 开头 。 同 样 , java -version 
返回 x， 所 以 在 Java 9 上 人 们 会 得 到 9.something。 
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版 本 字符 串 格式 

新 版 本 字符 串 的 确切 格式 仍 在 变化 中 。 在 Java9 中 , 人 们 将 得 到 9.S{MINOR} .S${SECURITY}. 
s{PATCH} ,期 ${SECURITY} 在 发 布 次 要 版 本 时 不 会 重 置 为 0 一 一 人 们 始终 可 以 查看 该 数字 ， 
判断 哪个 版 本 包含 更 多 安全 修补 程序 。 

在 Java 10 及 更 高 版 本 中 ， 人 们 将 得 到 $s {FEATURE} .S${INTERIM} .S${UPDATE} .S${PATCH}， 
其 中 ${FEATURE} 从 10 开始 ， 并 在 每 6 个 月 发 布 一 次 新 功能 版 本 时 增 大 。${INTERIM] 的 功能 
与 ${MINOR} 一 样 ,但 是 由 于 在 新 的 规划 中 没有 计划 引入 次 要 版 本 ,因此 假定 它 始终 保持 为 0。 





























很 遗憾 , 这 有 一 个 副作用 : 对 版 本 敏感 的 代码 可 能 会 突然 停止 正常 工作 ， 而 这 会 导致 奇怪 的 
行为 。 对 所 涉及 的 系统 属性 进行 全 文 搜索 可 以 找到 此 类 代码 。 

至 于 更 新 这 些 代码 ， 如 果 你 愿意 将 项 目 升 级 到 Java 9 及 以 上 版 本 , 就 可 以 避免 对 系统 属性 进 
行 解析 ， 转 而 使 用 新 的 Runtime .Version 类 型 ， 这 要 容易 得 多 。 

















Version version = Runtime.version(); 
// 在 Java 10 及 以 上 版 本 中 ， 使 用 `version.feature()、 
Switch (version.major()) { 
case 9: 
System.out.println("Modularity"); 
break; 
case 10: 
System.out .println("Local-Variable Type Inference"); 
break; 
case 11: 
System.out .println("Pattern Matching (we hope)"); 
break; 


6.5.2 工具 减少 





JDK 积累 了 大 量 的 工具 , 但 随 着 时 间 的 推移 ， 有些 工具 
一 些 包含 在 Java 9 的 移 除 名 单 中 。 
口 JDK 不 再 包括 JavaDB。 后 者 是 一 个 Apache Derby DB， 可 以 从 The Apach DB Project 网 站 
下 载 。 
口 VisualVM 不 再 与 JDK 捆绑 在 一 起 ， 而 是 成 了 一 个 独立 的 项 目 。 
口 hprof 代理 库 已 被 删除 ， 替 代 其 功能 的 工具 有 jcmd、jmap 和 Java Flight Recorder。 
口 删除 了 jhat 堆 可 视 化 工具 。 
口 删除 了 java-rmi .exe 和 java-rmi .cgi 启动 程序 。 替代 方法 是 使 用 servlet 通过 HTTP 
代理 RMI。 
口 native2ascii 工具 可 以 将 基于 UTF-8 的 属性 资源 包 转 换 为 ISO-8859-1。 但 是 ，Java 9 

及 以 上 版 本 支持 基于 UTF-8 的 包 ， 因 此 该 工具 变 得 多 余 并 被 删除 。 





六 | 


变 得 多 余 或 被 其 他 工具 取代 ， 而 其 中 
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此 外 ， 所 有 与 JEE 相关 的 命令 行 工 具 ( 比如 wsgen 和 xjc ) 在 Java 11 上 不 再 可 用 ， 因 为 它 
们 连同 所 属 模块 一 起 被 删除 了 (JEE 模块 的 详细 信息 参见 6.1 的 。 


6.5.3 ”琐碎 的 事情 


以 下 是 导致 Java 9 构建 失败 的 一 个 原因 。 从 Java 8 开始 ， 单 个 下 划 线 _ 不 再 用 作 标 识 符 ， 如 
果 在 Java9 上 这 样 使 用 它 ， 就 会 出 现 编译 错误 。 这 样 做 是 为 了 回收 下 划 线 , 将 其 作为 可 能 的 关键 
字 。 示 来 的 Java 版 本 将 赋予 它 特殊 的 意义 。 

男 一 个 原因 是 Thread.stop (Throwable) 会 抛 出 UnsupportedoperationException 异 

。 尽 管 其 他 几 个 stop 的 重 载 方法 工作 正常 ， 但 是 本 书 强烈 反对 使 用 它们 。 

JNLP 语法 已 经 更 新 ， 以 符合 XML 规范 并 “消除 不 一 致 ， 使 代码 维护 更 方便 ， 并 增强 安全 
性 ”。 

每 个 Java 版 本 都 移 除 了 一 些 废弃 的 JVM 选项 , Java9 也 不 例外 。Java 9 对 垃圾 收集 的 更 改 较 
多 ， 一 些 组 合 不 再 得 到 支持 (DefNew + CMS、ParNew + Serialold、 增 量 cMs )， 一 些 配 置 
被 移 除 ( -Xincgc、 -XxX:+CMSIncrementalMode、 -XX:+UseCMS-CompactAtFullCollection.、 
-XX:+CMSFUllGCsBeforeCompaction、-XX:+UseCMS-CollectionPassing ), 一 些 配置 被 
废弃 ( -xx:+UseParNewGC )。 接 下 来 的 Java 10 移 除了 -Xoss、-Xsqnopause、-Xoptimize、 
-Xboundthreads 和 -Xusealtsigs。 













































































6.5.4 ” Java 9、Java 10 和 Java 11 中 新 废弃 的 功能 


本 节 列 出 了 Java 9、Java 10 和 Java 11 中 废弃 的 一 些 内 容 : 
口 java.applet 包 中 的 AppletAPI， 以 及 appletviewer 工具 和 Java 浏览 器 插件 ; 
口 Java Web Start、JNLP 和 javaws 工具 ; 
口 并 发 标记 清除 (CMS ) 垃圾 收集 器 ; 
口 用 -xprof 激活 HotSpot FlatProfiler; 
口 bolicytool 安全 工具 。 
Java 10 和 Java 11 中 删除 的 废弃 功能 如 下 : 
口 Java 10 删除 了 FlatProfiler 和 policytool; 
口 Java 11 删除 了 Applet API 和 Web Start。 
更 多 相关 信息 、 详 细 信息 和 建议 的 替代 方案 ， 请 查看 发 布 说 明和 标记 为 要 删除 的 废弃 代码 
列表 。 




















6.6 小结 


口 JEE 模块 在 Java 9 中 遭 到 废弃 ， 在 Java 11 中 被 删除 。 需 要 尽快 找到 一 个 第 三 方 依 赖 来 满 























126 第 6 章 迁移 到 Java 9 及 以 上 版 本 的 兼容 性 挑战 








口 在 Java9 和 Java 10 中 ， 默 认 情 况 下 这 些 模块 不 会 被 解析 ， 这 可 能 导致 编译 时 和 运行 时 错 
误 。 要 解决 该 问题 ,要 人 么 使 用 实现 相同 API 的 第 三 方 依赖 ,要么 让 JEE 模块 与 
--add-modules 一 起 使 用 。 

口 应 用 程序 类 加 载 器 不 再 属于 URLClassLoader 类 型 ， 因 此 像 (URLClassLoader) 
getCclass() .getclassLoader() 这 样 的 代码 会 失败 。 解 决 方案 包括 : 只 依赖 
ClassLoader API， 即 使 这 意味 着 必须 删除 某 个 特性 ( 建议 ); 创建 一 个 层 来 动态 加 载 新 
代码 (推荐 ); 或 者 侵 和 人 类 加 载 器 内 部 , 使 用 BuiltinclassLoader 甚至 AppClassLoader 
(不 推荐 )。 

口 运行 时 镜像 的 目录 结构 发 生 了 变化 ， 你 可 能 必须 更 新 你 的 工具 ( 特别 是 IDE ) 才能 使 用 

Java 9 或 更 高 版 本 。 操 作 JDK/JRE 目录 的 代码 或 系统 资源 的 URL 也 需要 更 新 。 

口 对 构成 平台 的 类 进行 修改 的 一 些 机 制 被 删除 。 模 块 系统 为 其 中 的 大 多 数 提供 了 替代 方案 。 
和 不 要 使 用 紧凑 的 概述 文件 , 而 是 使 用 jlink 创建 运行 时 镜像 , 并 使 用 --1imit-modules 

配置 编译 。 
国 使 用 --patch-module、 --upgrade-module-path 或 类 路 径 ， 而 不 是 扩展 机 制 或 授 

权 标 准 机 制 。 
国 使 用 --system、 --release 或 --patch-module 代替 -Xbootclasspath 选项 。 

口 不 再 支持 编译 Java 5， 也 不 再 支持 使 用 -version:N 选项 基于 特定 Java 版 本 启动 应 用 

程序 。 

口 Java 的 命令 行 工 具 和 系统 属性 java .version 打印 的 版 本 为 9.s$ {MINOR} .S${SECURITY}. 
${PATCH} (Java9 ), 或 者 S${FEATURE} .S$S{INTERIM}) .S${UPDATE} .S${PATCH} (Java 10 
或 更 新 版 本 )， 这 意味 着 Java x 版 本 以 x 开头 而 不 是 1.x。 全 新 的 API Runtime.Version 
使 得 对 这 个 属性 的 解析 不 再 必要 。 

口 以 下 工具 被 删除 了 。 


mm Java 9: JavaDB 、VisualVM 、hprof 、jhat 、java-rmi.exe、java-rmi.cgi 和 



































































































































native2asciio 
m Java 10: policytool。 
mm Javall: idlj、 orbd、 schemagen、 servertool、 tnameserv、, wsgen.、 wsimport 
和 xjc。 
口 单一 下 划 线 不 再 是 有 效 的 标识 符 。 
口 JNLP 语法 已 经 更 新 ， 以 符合 XML 规范 。 所 以 人 们 可 能 不 得 不 更 新 JNLP 文 件 。 
D 每 个 Java 版 本 都 会 删除 弃 用 的 JVM 命令 行 选 项 ， 这 可 能 会 使 一 些 脚 本 不 能 正常 工作 。 
口 Java 9 废弃 了 Applet 技术 和 Java Web Start，Java 11 则 删除 了 它们 。 









































在 Java 9 及 以 上 版 本 中 
运行 应 用 程序 时 会 反复 
出 现 的 挑战 








本 章 内 容 

口 区 分 标准 化 的 、 受 支持 的 和 内 部 的 JDK API 
口 使 用 JDeps 查找 针对 JDK 内 部 API 的 依赖 
口 编译 和 运行 依赖 内 部 API 的 代码 

口 为 什么 包 分 裂 可 以 使 类 变 得 不 可 见 

口 修复 包 分 裂 





第 6 章 讨论 了 将 项 目 迁 移 到 Java 9 及 以 上 版 本 时 可 能 遇 到 的 一 些 问题 .一 旦 解决 了 这 些 问 题 ， 
人 们 就 不 会 再 遇 到 它们 一 一 除非 有 些 依 赖 仍 为 Java 9 之 前 的 版 本 。 本章 将 探讨 人 们 还 需要 应 对 的 
另外 两 个 挑战 。 

口 依赖 内 部 API 会 导致 编译 错误 (参见 7.1 节 )。 不仅 依赖 JDK 的 内 部 API ( 比如 sun .* 包 

中 的 类 ) 会 出 现 此 问题 ， 依 赖 类 库 或 框架 内 部 的 代码 也 是 如 此 。 

口 跨 工件 的 包 分 裂 会 导致 编译 时 和 运行 时 错误 (参见 7.2 节 )。 同 样 ， 这 也 可 能 发 生 在 代码 
和 JDK 模块 之 间 ， 以 及 任何 其 他 两 个 工件 之 间 ， 例 如 代码 和 第 三 方 依赖 。 

到 目前 为 止 ， 正 如 之 前 讨论 过 的 ,为 了 让 项 目 能 在 Java 9 及 以 上 版 本 中 运行 ， 人 们 必须 解决 
这 两 个 问题 。 而 且 不 止 于 此 ， 即 使 在 迁移 之 后 ,在 处 理 代 码 或 引入 新 的 依赖 时 ， 人 们 偶尔 也 会 遇 
到 这 两 个 问题 。 不 管 涉及 的 模块 类 型 如 何 ， 对 模块 内 部 和 包 分 裂 的 依赖 都 会 造成 问题 。 你 很 可 能 
在 与 类 路 径 相关 的 代码 、 平 台 模 块 (迁移 场景 ) 和 应 用 程序 模块 (在 Java9 及 以 上 版 本 中 运行 并 
正在 使 用 模块 的 场景 ) 中 遇 到 它们 。 

本 章 将 展示 如 何 打 破 模 块 的 封装 以 及 如 何 修复 包 分 裂 带 来 的 问题 ( 且 不 区 分 所 处 的 环境 )， 
并 结合 第 6 章 知识 ， 为 迁移 过 程 中 大 多 数 可 能 出 错 的 情况 做 好 准备 。 
















































































128 第 7 章 在 Java9 及 以 上 版 本 中 运行 应 用 程序 时 会 反复 出 现 的 挑战 





关于 类 路 径 


如 果 你 没有 读 第 6 章 ， 本 章 在 这 里 重复 一 遍 。 


而 不 是 模块 路 径 。 





口 类 路 径 仍 然 能 正常 工作 , 在 迁移 到 Java9 及 以 上 版 本 的 过 程 中 , 你 可 以 继续 使 用 类 路 径 


口 即便 如 此 ， 模 块 系统 仍然 在 发 挥 作用 ， 特 别 是 在 强 封装 方面 。 
口 类 路 径 上 的 代码 将 自动 读 取 大 部 分 模块 (但 不 是 所 有 模块 ， 参 见 6.1 节 )， 这 样 在 编译 


时 或 运行 时 ， 人 们 无 须 额外 配置 就 可 以 使 用 它们 。 


7.1 内 部 API 的 封装 





模块 系统 最 大 的 卖点 之 一 是 强 封装 。 正 如 3.3 节 深 入 讨论 的 那样 ， 人 们 终于 可 以 在 隐藏 实现 
细节 的 同时 确保 只 有 受 支 持 的 API 才能 被 外 部 代码 访问 了 。 

内 部 API 的 不 可 访问 性 仅 适 用 于 JDK 附带 的 平台 模块 ， 其 中 只 有 java.* 和 javax.* 是 完 
全 受 支 持 的 包 。 例如， 当 你 试图 在 现 有 封装 包 com.sun.java.swing.plaf.nimbus 的 
NimbusLookAndFeel 上 编译 具有 静态 依赖 的 类 时 ( 即 导 入 完全 限定 类 名 ， 而 不 是 反射 访问 )， 





就 会 发 生 这 种 情况 。 
> 
i 
> 
> 
> 
> 1 error 


令 人 惊讶 的 是 , 许多 类 库 、 框 架 以 及 应 用 程 











error: package com.sun.java.swing.plaf.nimbus is not visible 

import com.sun.java.swing.plaf.nimbus.NimbusLookAndFeel; 
(package com.sun.java.swing.plaf.nimbus is declared 
in module java.desktop, which does not export it) 





序 代 码 (通常 是 相对 重要 的 部 分 ) 会 使 用 sun.* 


























或 com.sun.* 包 中 的 类 ， 而 从 Java 9 开始 ， 这 些 中 的 大 部 分 是 不 可 访问 的 。 本 节 将 展示 如 何 找 


到 有 这 种 依赖 关系 的 代码 ， 以 及 如 何 处 型 





它们 。 











但 是 为 什么 要 讨论 这 个 呢 ? 如 果 内 部 API 不 可 访问 ， 那 就 没什么 可 谈 的 了 ， 对 吧 ? 好 了 ,是 








时 候 揭 露 一 些 真 相 了 : 它们 并 不 是 完全 不 可 访问 。 在 运行 时 ， 直 到 下 一 个 主要 的 Java 版 本 发 布 ， 





一 切 都 可 以 正常 工作 ( 尽管 可 能 会 收 到 一 些 不 想 要 的 警告 消息 )。 只 要 控制 命令 行 ， 就 可 以 在 编 


译 时 访问 任何 包 。( 我 想 我 刚才 听 到 了 一 声 宽慰 的 叹息 ， 是 你 吗 ?” ) 






































9.1.4 节 将 讨论 使 用 命令 行 选项 配置 模块 系统 的 含义 ， 现 在 先 着 眼 于 比较 紧迫 的 问题 。 本 章 
将 区 分 静态 访问 和 反射 访问 ， 以 及 编译 时 访问 和 运行 时 访问 (参见 7.1.3 节 和 7.1.4 节 )， 因 为 它 
们 的 一 些 区 分 非常 关键 。 但 是 在 此 之 前 ， 你 需要 确切 地 了 解 是 什么 构成 了 内 部 API， 以 及 Java 
依赖 关系 分 析 工 具 (JDeps ) 如 何在 项 目 和 依赖 关系 中 帮助 人 们 发 现 有 问题 的 代码 。 



































Q@ 此 处 应 为 作者 的 一 种 幽默 表达 。 一 一 译 者 注 
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提示 。 如 果 你 不 确定 反射 到 底 是 如 何 工 作 的 ,请 查看 附录 B, 它 给 出 了 一 个 简要 的 介绍 。 

此 外 , 本 节 将 重点 讨论 JDK 的 反射 访问 , 模块 世界 中 反射 的 更 一 般 的 视图 请 看 第 12 章 。 

在 完成 本 节 的 学 习 之 后 , 你 就 可 以 轻松 地 打破 模块 封装 的 柳 锁 ， 从 维护 人 员 不 希望 你 使 用 的 
API 中 获 益 。 更 重要 的 是 ， 你 将 能 够 评估 该 策略 的 优点 和 缺点 ， 从 而 明智 地 决定 这 条 路 是 和 否 值得 
走 下 去 。 



































7.1.1 微观 视角 下 的 内 部 API 


哪些 是 内 部 的 API? 一 般 来 说 ， 每 个 不 在 导出 包 中 的 或 非 公 有 类 的 API 都 是 内 部 API。 这 条 
规则 完全 适用 于 应 用 程序 模块 。 但 对 于 JDK 而 言 ， 答 案 并 不 是 那么 简单 。 在 标准 化 的 、 受 支持 
的 和 内 部 的 API 已 经 非常 复杂 的 历史 之 上 ，Java9 及 以 上 版 本 为 一 些 API 提供 了 特殊 的 情况 ,并 
移 除 了 一 些 API， 从 而 又 为 此 增加 了 一 层 复 杂 性 。 现 在 ， 一 步 一 步 来 把 它 弄 清楚 。 


1.3 种 JDKAPI: 标准 化 的 、 受 支持 的 和 内 部 的 

从 历史 上 看 ，Java 运行 时 环境 (JRE) 有 3 种 API。 

口 java.* 包 和 javax.* 包 中 的 公有 类 在 所 有 JRE 中 都 是 标准 化 的 且 完 全 受 支 持 , 仅 使 用 这 

些 包 就 可 以 生成 可 移植 性 最 强 的 代码 。 

口 一 些 com. sun.* 包 和 jdk.* 包 及 其 包含 的 一 些 被 标记 为 jdk .Exported 注解 的 类 ,在 这 
种 情况 下 ，Oracle 支持 它们 但 在 非 Oracle 的 JRE 中 不 一 定 ， 这 取决 于 这 些 代 码 采 用 的 具 
体 JRE。 

口 大 多 数 com. sun.* 包 、 所 有 sun .* 包 以 及 所 有 非 公 有 类 是 内 部 的 ， 但 是 在 不 同 的 版 本 和 
JRE 之 间 可 能 有 所 不 同 。 对 它们 的 依赖 是 最 不 稳定 的 , 因为 理论 上 任何 小 更 新 都 可 能 导致 
代码 无 法 正常 工作 。 

在 Java 9 及 以 上 版 本 和 模块 系统 的 作用 下 , 这 3 种 API (标准 化 的 、 受 支持 的 和 内 部 的 ) 仍 

然 存 在 。 一 个 模块 是 否 导 出 一 个 包 是 一 个 关键 指标 ,但 这 显然 不 足以 被 划分 为 3 个 类 别 。 另 一 个 

此 示 符 是 模块 的 名 称 ， 你 可 能 还 记得 在 3.1.4 节 中 ， 平台 模 块 被 划分 为 Java 规范 定义 的 模块 ( 以 
java.* 作 为 前 级 ) 和 特定 于 JDK 的 模块 (以 jdk.* 作 为 前 级 )。 

口 java.* 模 块 导出 的 包 中 包含 的 公有 类 ( java.* 包 和 javax.* 包 ) 是 标准 化 的 。 

口 jdk.* 模 块 导出 的 包 中 包含 的 公有 类 不 是 标准 化 的 ， 而 是 由 Oracle 和 OpenJDK 的 JDK 所 

支持 的 。 

口 其 他 所 有 类 是 内 部 的 API。 

从 Java 8 到 Java 9 及 以 上 版 本 ， 哪 些 特定 的 类 是 标准 化 的 、 受 支持 的 或 内 部 的 基本 没有 变 

化 。 因 此 ， 和 以 前 一 样 ，com. sun.* 包 中 的 大 多 数 类 和 sun .* 包 中 的 所 有 类 是 内 部 API。 不同 

之 处 在 于 , 模块 系统 将 习惯 性 约定 转换 为 了 积极 的 强制 区 分 , 图 7-1 显示 了 没有 导出 的 内 部 API 

划分 。 
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图 


包 中 的 所 有 公有 类 型 java.* 模 块 中 导出 的 
都 是 标准 化 的 包 是 标准 化 的 


Java8 Java 9 
TO java.* 模块 
| i en fm 
站 当 时 六 /1 允 [a 日 
. 没 导 出 的 包 是 
一 [一 [一 用 的 
3 


圆 标准 化 的 API 因 受 支持 的 API 口内 部 API 




















包 中 的 大 多 数 类 型 (甚至 jdk* 模块 中 导出 的 
是 公有 类 型 ) 是 内 部 的 ， 包 是 受 支持 的 
但 是 至 少 有 一 些 类 型 是 由 

特定 的 JVM 供 应 商 支持 的 


7-1 在 Java 8 ( 左 ) 中 , 包 名 和 @jdk.Exported 注解 决定 API 是 标准 化 的 、 受 支持 
的 还 是 内 部 的 。 从 Java 9 开始 ( 右 )， 模块 名 和 导出 指令 实现 了 这 个 功能 














2. 臭名 昭著 的 sun .misc .unsafe 特例 

正如 你 所 想 的 那样 ， 最 初 的 想法 是 封装 Java 9 之 前 的 每 个 内 部 API。2015 年 ， 当 这 一 决定 在 
Java 社 区 宣布 时 ,引起 了 一 阵 骚动 。 虽 然 普通 Java 开发 人 员 可 能 只 是 偶尔 使 用 内 部 API, 但 许多 
最 为 知名 的 类 库 和 框架 会 经 常 使 用 这 些 内 部 API， 而 且 它 们 的 一 些 关 键 特性 也 依赖 于 此 。 

这 种 情况 的 典型 代表 是 sun .misc.Unsafe 类 , 从 它 的 包 名 来 看 , 它 明显 是 内 部 的 。 它 提供 
了 一 些 Java 中 不 常用 的 功能 ， 而 且 正 如 类 名 所 示 ， 它 是 不 安全 (unsafe ) 的 。 也 许 最 好 的 例子 是 












































直接 访问 内 存 ，JDK 有 时 必须 执行 这 种 操作 。 





但 它 越过 了 JDK。 由 于 可 以 使 用 Unsafe 类 , 一 些 类 库 , 特别 是 那些 重视 高 性 能 的 库 ， 开始 
使 用 它 ; 随 着 时 间 的 推移 ,它们 生态 系统 的 大 部 分 直接 或 间接 地 依赖 它 。 未 来 这 个 类 和 其 他 类 似 
的 类 将 被 封装 的 消息 引发 了 社区 的 骚动 。 

在 此 之 后 ， 从 事 Jigsaw 项 目的 团队 决定 实现 更 平滑 的 迁移 路 径 。 对 于 现 有 内 部 API 及 其 在 





JDK 之 外 的 使 用 调查 得 出 了 以 下 结果 。 


口 大 

















多 数 受 影响 的 API 很 少 或 从 未 被 使 用 。 





口 一 些 受 影响 的 API 虽然 只 是 偶尔 被 使 用 , 但 它们 在 Java9 之 前 就 存在 标准 化 的 蔡 代 方案 。 








个 典型 的 例子 是 sun.misc 包 中 的 BASE64Encodqer/BASE64Decoder ， 它 可 以 用 








java.util.Base64 进行 替换 。 


口 还 有 一 些 受 影响 的 API 虽然 只 是 偶尔 被 使 用 ， 但 它们 是 完成 重要 功能 的 关键 所 在 ， 并 且 























没有 其 他 的 替代 方案 ， 例 如 sun.misc.Unsafe。 
最 终 的 决定 是 封装 前 两 种 API， 而 将 第 三 种 类 型 至 少 保留 到 下 一 个 主要 的 Java 版 本 。 但 是 ， 
将 它们 从 各 自 的 模块 导出 会 让 人 感到 困惑 ， 因 为 这 会 使 它们 看 起 来 像 受 支持 的 、 甚 至 是 标准 化 的 
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API( 而 它们 绝对 不 是 )。 为 它们 创建 一 个 命名 得 当 的 模块 是 否 是 一 个 更 好 的 解决 方案 呢 ? 
jdk.unsupported 导出 的 是 Java 9 之 前 不 存在 替代 方案 的 核心 API。 顾 名 思 义 ， 它 特定 于 JDK 

(只 保证 出 现在 Oracle JDK 和 OpenJDK 中 )， 且 不 受 支 持 (内 容 可 能 在 下 一 个 版 本 中 更 改 )。 在 

Java9 至 Java 11 中 ， 包 含 以 下 类 : 

口 sun.misc 包 中 的 Signal、 SignalHandler 和 Unsafe; 

口 sun.reflect 包 中 的 Reflection 和 ReflectionFactory; 





























口 com. sun.nio.file 包 中 的 ExtendedCopyOption、FExtendedOopenOption、FExtended- 








WatchEventModifier 和 SensitivitywatchEventModifier。 
如 果 代 码 或 依赖 关系 依赖 于 这 些 类 ( 如 何 查 找 可 以 参考 7.1.2 前 ， 那 么 即使 它们 在 Java 9 之 
前 是 内 部 API， 你 也 不 需要 做 任何 事情 来 继续 使 用 它们 。 现 在 ,伴随 着 标准 化 的 替代 方案 的 发 布 
(比如 替换 Unsafe 的 变量 句柄 )， 它 们 将 被 封装 起 来 。 强 烈 建 议 你 仔细 研究 一 下 这 些 类 的 用 法 ， 
并 为 它们 的 最 终 消失 做 好 准备 。 


3. 被 移 除 的 API 

尽管 一 些 内 部 API 还 可 以 使 用 几 年 ,并且 大 多 数 API 已 被 封装 ， 但 有 一 些 API 遭遇 了 更 残 
酷 的 命运 : 被 移 除 或 重 命名 。 对 使 用 它们 的 代码 而 言 ,这 带 来 的 破坏 比 任何 过 渡 和 命令 行 选项 都 
要 严酷 。 下 面 是 遭 到 移 除 或 重 命名 的 列表 : 

口 没有 被 包含 在 jdk.unsupported 中 的 sun .misc 和 sun.reflect 的 类 ， 例 如 sun.misc . 


BASE64Encoder、 sun.misc.BASE64Decoder、sun.misc.Cleaner 和 sun.misc . 


































































































Service; 
D com.sun.image.codec.jpeg 和 sun.awt.image.codec; 
DQ com.apple.concurrent; 


DQ com.sun.security.auth.callback.DialogCallbackHandler; 








口 java.util.logging.LogManager 中 的 addPropertyChangeListener 和 remove- 
PropertyChangeListener 方法 、java.util.jar.Pack200.Packer 以 及 java. 
util.jar.Pack200.Unpacker (在 Java 8 中 遭 到 废弃 ); 

D java.awt.peer 和 java.awt.dnd.peer 中 的 带 参 方法 或 返回 值 ( 这些 包 从 未 标准 化 ， 
在 Java 9 及 更 高 版 本 中 是 内 部 的 )。 

这 些 类 和 包 中 的 大 多 数 有 替代 方案 ， 可 以 使 用 JDeps 了 解 它们 。 


7.1.2 使 用 JDeps 分 析 依 赖 


前 文 已 经 讨论 了 标准 化 的 、 受 支持 的 和 内 部 的 API， 以 及 jdk.unsupported 的 特殊 情况 ， 现 在 
是 时 候 将 这 些 知识 应 用 到 实际 项 目 中 了 。 要 想 与 Java 9 及 以 上 版 本 兼容 , 你 需要 确定 项 目 依 赖 于 
哪些 内 部 API。 

仅仅 浏览 项 目的 代码 库 不 能 解决 所 有 问题 一 一 如 果 它 所 依赖 的 类 库 和 框架 导致 问题 , 那么 项 
目 也 会 遇 到 麻烦 ， 所 以 你 也 需要 分 析 它 们 。 这 项 工作 听 起 来 非常 可 怕 , 仿佛 需要 在 搜索 此 类 API 
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的 引用 时 手动 筛选 大 量 代 码 。 幸 好 ， 你 没 必要 那么 做 。 

自 Java 8 以 来 ，JDK 附带 了 命令 行 Java 依赖 关系 分 析 工 具 ( Java Dependency Analysis Tool， 
JDeps )。 此 工具 分 析 Java 字 节 码 ( 即 .class 和 JAR 文件 )， 记 录 类 之 间 所 有 静态 声明 的 依赖 关系 ， 
并 且 可 以 过 滤 或 聚合 这 些 依 赖 关 系 。 这 是 一 种 很 好 的 工具 , 可 以 用 于 可 视 化 和 研究 一 直 在 讨论 的 
各 种 依赖 关系 图 。 附 录 DD 提供 了 JDeps 指南 ， 如 果 从 未 使 用 过 JDeps， 那 么 你 可 能 想 要 阅读 它 。 
不 过 严格 来 说 ， 要 使 用 JDeps 并 非 必须 理解 本 节 。 

一 个 特别 有 趣 的 特性 是 内 部 API 上 下 文 。 选 项 --jdk-internals 使 JDeps 列 出 了 依赖 JAR 
引用 的 所 有 内 部 API， 包 括 jdk.unsupported 导出 的 API。 输 出 内 容 如 下 : 

口 分 析 包 含有 问题 API 的 JAR 和 模块 ; 
口 涉及 的 具体 类 ; 
口 问题 依赖 的 原因 。 

我 将 在 Scaffold Hunter (“一 个 开放 源码 的 基于 Java 的 工具 ， 用 于 数据 集 的 可 视 化 分 析 ”) 上 

使 用 JDeps。 下 面 的 命令 会 分 析 内 部 依赖 关系 。 

















$ jdeps --jdk-internals -中 告诉 JDeps 分 析 内 部 API 的 使 用 
-R --class-path 'libs/*' 十 | 递归 分 析 所 有 依赖 
scaffold-hunter-2.6.3.jar a | 从 应 用 程序 JAR 开始 

S 任 日 


输出 以 包 分 裂 开始 〈7.2 节 将 介绍 这 些 包 )， 然 后 是 关于 有 问题 的 依赖 关系 的 报告 ， 下 面 将 展 
示 其 中 一 些 。 输 出 非常 详细 并 提供 了 你 需要 的 信息 , 以 便 检 查 相 关 代码 或 对 应 项 目 中 的 开放 问题 。 

















JPEGImageWriter (此 处 省 略 了 batik-codec 依赖 阐述 问题 
包 名 ) 依赖 于 几 个 不 同 的 类 于 已 删除 的 API 所 在 
> batik-codec.jar -> JDK removed internal API Es 
> JPEGImageWriter -> com.sun.image.codec.jpeg.JPEGCodec 
> JDK internal API (JDK removed internal API) 
3 JPEGImageWriter -> com.sun.image.codec.jpeg.JPEGEncodeParam 
> JDK internal API (JDK removed internal API) 
> JPEGImageWriter -> com.sun.image.codec.jpeg.JPEGImageEncoder 
> JDK internal API (JDK removed internal API) Guava 依赖 于 
sse jdk.unsupported 
> guava-18.0.jar -> jdk.unsupported 十 外 pp 
> SEE ReQ84 本 Sunsmrso. Unsafe sr | Striped64 依赖 于 sun.misc.Unsafe 
全 JDK internal API (jdk.unsupported) ss A i 
> Striped64s$1 -> sun.misc.Unsafe 以 及 它 的 两 个 内 部 类 
> JDK internal API (jdk.unsupported) 
> Striped64s$Cell -> sun.misc.Unsafe 
> JDK internal API (jdk.unsupported) 
Pe Scaffold Hunter 依赖 于 java.desktop 
> scaffold-hunter-2.6.3.jar -> java.desktop 的 内 部 类 
六 SteppedComboBox -> com.sun.java.swing.plaf.windows .WindowsComboBoxUI 
> JDK internal API (java.desktop) 
> SteppedComboBoxs$1 -> com.sun.java.swing.plaf.windows .WindowsComboBoxUI 
> JDK internal API (java.desktop) 
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JDeps 以 下 面 的 注释 结束 ， 此 处 为 发 现 的 一 些 问 题 提 供 了 有 用 的 背景 信息 和 建议 。 








> Warning: JDK internal APIS are unsupported and private to JDK 

> implementation that are subject to be removed or changed incompatibly 

> and could break your application. Please modify your code to eliminate 
> dependence on any JDK internal APIs. For the most recent update on JDK 
> internal API replacements, please check: 

> https://wiki.openjdk.java.net/display/JDK8/Java+Dependency+Analysis+Tool 
> JDK Internal API Suggested Replacement 

Se 

> com.sun.image.codec.jpeg.JPEGCodec Use javax.imageio @since 1.4 
> com.sun.image.codec.jpeg.JPEGDecodeParam Use javax.imageio @since 1.4 
> com.sun.image.codec.jpeg.JPEGEncodeParam Use javax.imageio @since 1.4 
> com.sun.image.codec.jpeg.JPEGImageDecoder Use javax.imageio @since 1.4 
> com.sun.image.codec.jpeg.JPEGImageEncoder Use javax.imageio @since 1.4 
> com.sun.image.codec.jpeg.JPEGQOTable Use javax.imageio @since 1.4 
> com.sun.image.codec.jpeg.TruncatedFileException 

> Use javax.imageio @since 1.4 
> sun.misc.Unsafe See JEP 260 

> sun.reflect.ReflectionFactory See JEP 260 


7.1.3 编译 内 部 API 


强 封装 的 目的 是 使 模块 系统 在 默认 情况 下 不 能 使 用 内 部 API。 这 将 影响 Java 9 以 后 任何 版 本 
的 编译 和 运行 时 行为 。 本 节 将 讨论 编译 部 分 ，7.1.4 节 将 讨论 运行 时 行为 。 开 始 时 ， 强 封装 主要 
与 平台 模块 相关 ， 但 是 随 着 依赖 逐渐 被 模块 化 ， 你 将 遇 到 与 平台 模块 相同 的 问题 。 

不 过 , 有 时 可 能 会 遇 到 这 样 的 情况 : 你 必须 使 用 非 导 出 包 中 的 公有 类 来 解决 现实 问题 。 幸 好， 
即使 在 使 用 模块 系统 的 情况 下 ， 人 们 也 可 以 这 么 做 ( 尽管 这 话 可 能 多 余 , 但 本 书 仍 要 指出 ,这 只 
是 你 的 代码 的 问题 ,因为 你 的 依赖 已 经 编译 好 了 一 一 它们 仍然 会 受到 强 封装 的 影响 , 但 仅 在 运行 
时 才 会 受到 影响 )。 


























导出 到 模块 

java 和 javac 命令 行 选项 --add-exports s{module}/s{package}=s${reading- 
module} 叶 出 Sftmodule} 的 Sfpackage} 到 s{reading-module}， 因 而 S$S{reading-module} 
中 的 代码 可 以 访问 $f{package} 中 的 所 有 公有 类 型 ， 但 是 其 他 模块 不 可 以 访问 。 

当 s{reading-module} 被 赋值 为 ALL-UNNAMED 时 ， 类 路 径 上 的 所 有 代码 都 可 以 访问 对 
应 的 包 。 在 迁移 到 Java9 及 以 上 版 本 时 ， 你 将 始终 使 用 该 占 位 符 一 只 有 自己 的 代码 在 模块 中 
运行 时 ， 你 才能 限制 导出 到 特定 的 模块 。 








到 目前 为 止 ， 导 出 始终 没有 到 具体 的 目标 ， 因 此 能 够 导出 到 特定 模块 被 认为 是 一 个 新 功能 。 
这 个 特性 也 适用 于 模块 描述 符 ，11.3 节 将 解释 这 一 点 。 另 外 ， 现 在 ALL-UNNAMED 的 含义 还 有 点 
不 明确 ， 它 与 无 名 模块 有 关 ，8.2 节 将 对 此 进行 详细 讨论 ， 但 目前 “所 有 来 自 类 路 径 的 代码 ”是 
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一 个 不 错 的 解释 。 
回 到 导致 以 下 编译 错误 的 代码 。 

















error: package com.sun.java.swing.plaf.nimbus is not visible 
import com.sun.java.swing.plaf.nimbus.NimbusLookAndFeel; 
(package com.sun.java.swing.plaf.nimbus is declared 
in module java.desktop, which does not export it) 


> 
> 
Sw 
> 
> 
> 1 error 





这 里 ,一 些 类 ( 在 输出 中 省 略 了 ， 因 为 它 与 当前 问题 不 相关 ) 从 封装 的 包 com. sun. java. 
swing.plaf.nimbus 中 导入 了 NimbusLookanaqFeel ,请 注意 错误 消息 是 如 何 指出 特定 问题 的 ， 
包括 包含 该 类 的 模块 。 

这 在 Java 9 中 显然 行 不 通 ， 但 是 如 果 想 继续 使 用 它 呢 ? 那么 你 可 能 会 犯错 误 ， 因 为 
javax.swing.plaf.nimbus 中 有 一 个 标准 化 的 替代 方案 。Java 10 中 只 保留 了 该 版 本 ， 并 因此 
删除 了 内 部 版 本 。 但 是 在 这 个 示例 中 , 假设 你 仍然 希望 使 用 内 部 版 本 ( 可 能 是 为 了 与 无 法 更 改 的 
遗留 代码 进行 交互 )。 

想 要 成 功 编译 com. sun.java.swing.plaf.nimbus.NimbusLookandqFeel， 你 所 要 做 的 
就 是 添加 命令 行 选项 --add-exports java.desktop/com.sun.java.swing.plaf.nimbus= 
ALL-UNNAMED。 如 果 和 手动 执行 该 操作 ,将 与 以 下 内 容 类 似 ( 所 有 占 位 符 都 必须 用 具体 的 值 替 换 )。 

$ javac 

--add-exports java.desktop/com.sun.java.swing.plaf.nimbus=ALL-UNNAMED 
--class-path $s{dependencies} 


-d ${target-folder} 
Ss{source-files} 


在 使 用 构建 工具 时 ,必须 将 该 选项 放 在 构建 描述 符 的 某 个 位 置 。 检 查 工具 的 文档 ， 了 人 解 如 何 
为 编译 器 添加 命令 行 选 项 。 

这 样 , 代码 就 可 以 轻松 地 编译 封装 的 类 了 。 但 你 需要 意识 到 , 这 只 是 将 问题 拖延 到 了 运行 时 ! 
这 个 命令 行 选项 只 会 改变 编译 , 而 不 会 在 字 节 码 中 添加 任何 额外 信息 , 更 不 会 使 该 类 得 以 在 执行 
期 间 访问 包 。 你 仍然 需要 和 弄 清楚 如 何 使 它 在 运行 时 工作 。 




























































































7.1.4 运行 内 部 API 


前 文 提 到 ， 至 少 在 Java 9、Java 10 和 Java 11 中 ，JDK 内 部 依赖 在 运行 时 仍然 可 用 。 根 据 前 
文 的 其 他 内 容 , 这 应 该 有 点 令 人 惊讶 。 本 书 一 直 在 强调 强 封装 的 好 处 ， 并 说 它 和 访问 修饰 符 一 样 
重要 ， 那 为 什么 在 运行 时 不 强制 执行 呢 ? 

与 许多 其 他 Java 的 奇异 特性 一 样 ， 这 个 特性 源 于 对 向 后 兼容 的 执着 : 针对 JDK 内 部 的 强 封 
装 将 破坏 许多 应 用 程序 。 即 使 只 是 对 NimbusLookAndFeel 的 过 时 使 用 进行 封装 ， 应 用 程序 也 
会 崩溃 。 如 果 遗 留 的 应 用 程序 将 停止 工作 ， 那 么 有 多 少 终端 用 户 或 开 部 门 会 安装 Java 9 及 以 上 
版 本 ?如果 没 有 用 户 使 用 Java 9 及 以 上 版 本 ， 那 又 会 有 多 少 团 队 使 用 它 进 行 开发 呢 ? 
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为 了 保证 模块 系统 不 会 导致 Java 生态 系统 分 裂 成 “Java 9 之 前 ”和 “Java 9 之 后 ” ， 最 终 的 
决定 是 ,授予 类 路 径 中 的 代码 对 JDK 内 部 API 进 行 非法 访问 的 权限 ,该 权限 将 至 少 持 续 到 Java 11。 





这 其 中 的 每 个 选择 都 经 过 了 深思 熟 虑 。 
D 类 路 径 中 的 代码 …… 























更 新 的 意愿 就 会 降低 。 





运行 模块 路 径 中 的 代码 表明 它 已 经 为 模块 系统 做 好 了 准备 。 这 
种 情况 下 没有 必要 保留 例外 。 所 以 它 只 限于 类 路 径 中 的 代码 。 

D …… 对 JDK 内 部 API-- 从 兼容 性 的 角度 来 说 ， 没 有 理由 授予 对 应 用 程序 模块 的 访问 权 
限 ， 因 为 在 Java 9 之 前 它们 还 不 存在 。 所 以 例外 只 局 限于 平台 模块 。 

口 …… 至 少 持续 到 Java 11 一 一 如 果 例 外 是 永久 性 的 , 那么 对 这 些 容易 造成 麻烦 的 代码 进行 








如 你 在 第 6 章 所 见 ， 尽管 这 并 没有 解决 应 用 程序 在 Java 9、Java 10 或 Java 11 中 运行 时 有 可 




















能 遇 到 的 所 有 问题 ， 但 是 运行 成 功 的 可 能 性 还 是 很 大 的 。 
1. 管理 对 JDK 内 部 API 的 全 面 非法 访问 




















要 成 功 进行 迁移 ， 理 解 对 JDK 内 部 API 进行 全 面 非法 访问 的 细节 是 非常 重要 的 ， 但 是 对 它 
的 探索 会 让 模块 系统 的 思想 模型 更 加 复杂 。 它 帮助 人 们 将 全 局 牢记 于 心 : 强 封装 禁止 了 对 所 有 内 
部 API 的 编译 时 和 运行 时 访问 。 除 此 之 外 ,有 一 个 重要 例外 , 但 是 这 个 例外 只 是 为 了 兼容 性 而 设 
计 的 。 随 着 时 间 的 推移 ， 这 个 例外 将 消失 ， 把 人 们 带 回 到 更 加 轮廓 清晰 的 行为 上 。 

在 让 类 路 径 代码 访问 JDK 内 部 API 时 ， 对 静态 依赖 的 代码 和 通过 反射 访问 的 代码 进行 了 



































区 分 。 


可 靠 地 报告 问题 的 时 机 是 执行 。 




















容易 导致 问题 。 






































口 反射 访问 将 导致 警告 。 因 为 静态 分 析 不 可 能 对 所 有 这 样 的 调用 进行 准确 识别 ， 唯 一 能 够 


口 静态 访问 不 会 导致 警告 。 人 们 可 以 很 容易 地 在 编译 期 间或 者 通过 JDeps 发 现 这 些 访问 。 由 
于 静态 访问 广泛 存在 ， 这 也 成 为 一 个 对 性 能 敏感 的 领域 





检查 并 偶尔 打印 日 志 信 息 很 


精确 的 行为 可 以 通过 命令 行 选项 配置 。java 命令 行 参 数 --i1legal-access=s$fvalue} 可 





以 指定 如 何 处 理 对 JDK 内 部 API 的 非法 访问 ， 其 中 s {valu 





D permit 
的 第 一 次 访问 会 产生 一 条 警告 。 





D warn 

















e} 可 以 是 以 下 几 个 值 之 一 。 


允许 类 路 径 中 的 代码 访问 所 有 JDK 内 部 API。 在 使 用 反射 访问 时 ， 对 某 个 包 


行为 与 permit 类 似 , 但 是 每 次 反射 访问 都 会 产生 一 条 警告 。 
口 debug 一 一 行为 与 warn 类 似 ,但 是 每 条 警告 都 带 有 一 个 栈 跟踪 信息 。 
口 deny 一 一 强 封装 所 使 用 的 选项 : 默认 禁止 所 有 非法 访问 。 








在 Java9 到 Java1l 中 ，permit 是 默认 值 。 在 将 来 的 Java 版 本 中 ，gdeny 将 是 默认 值 ， 并 且 





某 一 天 整个 选项 都 会 消失 ， 但 是 肯定 需要 几 年 的 时 间 。 


看 上 去 一 旦 让 有 问题 的 代码 通过 了 编译 ( 不 论 是 使 用 Java 8， 还 是 通过 添加 必要 的 选项 而 使 








用 Java 9 及 以 上 版 本 )，Java 9 及 以 上 版 本 的 运行 时 就 会 小 心 倒 慢 地 执行 它 。 为 了 实践 


--illegal-access 选项 ,现在 是 时 候 最 终 看 一 下 调用 内 部 类 NimpbusLookAndFeel 的 代码 了 。 
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import com.sun.java.sSwing.plaf.nimbus.NimbusLookAndqFeel: 
public class Nimbus { 


public static void main(String[] args) throws Exception { 
NimpbusLookAndrFeel nimbus = new NimbusLookAndFeel (); 
System.out .println("Static access to " + nimbus); 


Object nimbusByReflection = Class 
.forName ("com.sun.java.swing.plaf.nimbus.NimbusLookAndFeel") 
.getConstructor() 
.newInstance(); 

System.out .println("Reflective access to " + nimbusByReflection); 


} 


除了 试图 通过 静态 或 者 反射 来 访问 NimbusLookAndFeel, 它 没有 做 任何 有 用 的 事情 。 如 前 
文 所 述 ， 你 需要 使 用 --add-exports 选项 进行 编译 。 执 行 它 则 比较 简单 。 


$ java --class-path S${class} j9ms.internal.Nimbus 

















Static access to "Nimbus Look and Feel" 

WARNING: An illegal reflective access operation has occurred 

WARNING: Illegal reflective access by jg9ms .Internal.Nimbus 
(file:...) to constructor NimbusLookAndFeel () 

WARNING: Please consider reporting this to the maintainers 
of j9ms.internal.Nimbus 

WARNING: Use --illegal-access=warn to enable warnings of 
further illegal reflective access operations 

WARNING: All illegal access operations will be denied in a 
future release 

Reflective access to "Nimbus Look and Feel" 


你 可 以 观察 默认 选项 --illegal-access=permit 所 定义 的 行为 : 静态 访问 成 功 了 ， 并 且 
没有 任何 提示 ; 而 反射 访问 导致 了 一 连 串 警 告 。 将 选项 改 为 warn 不 会 有 任何 改变 ， 因 为 这 里 只 
有 一 次 访问 。 然 后 , aebug 针对 有 问题 的 调用 添加 了 栈 跟 踪 信 息 。 使 用 aeny 则 会 得 到 错误 提示 ， 
此 提示 与 3.3.3 节 测 试 访问 需求 时 所 展示 的 提示 相同 。 


S java 

--class-path S${class} 

--illegal-access=deny 

j9ms.internal.Nimbus 
> Exception in thread "main" java.lang.IllegalAccessError: 
class j9ms.internal.Nimbus (in unnamed module Q0x6bc168e5) cannot 
access class com.sun.java.swing.plaf.nimbus.NimbusLookAndFeel (in 
module java.desktop) because module java.desktop does not export 
com.sun.java.swing.plaf.nimbus to unnamed module @0x6bcl68e5 


还 有 一 个 细节 需要 讨论 : 对 Java9 引入 的 JDK 内 部 代码 的 非法 访问 会 怎么 处 理 ? --illegal- 
access 选项 的 引入 本 是 为 了 简化 迁移 过 程 ， 如 果 由 于 它 的 存在 ， 人 们 开始 依赖 新 的 内 部 APT， 
导致 最 终 的 迁移 过 程 更 加 复杂 ， 那 真是 太 尴 办 了 。 这 确实 是 个 风险 ! 


VV VV VV VVVvVvV 
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了 要 点 “为 了 减 小 依赖 新 的 JDK 内 部 API 的 风险 ，--illegal-access 对 Java 9 


向) 所 引入 的 包 不 会 产生 效果 。 这 缩小 了 项 目 可 能 意外 依赖 的 新 API 的 范围 ， 现 在 只 
有 Java9 之 前 就 存在 的 包 中 增加 的 新 类 才 有 这 种 风险 。 


为 了 兼容 性 而 做 的 那些 事情 ， 如 前 文 所 述 , 会 变 得 更 加 复杂 。 但 是 这 还 不 是 终点 ,因为 人 们 
可 以 更 有 针对 性 地 管理 非法 访问 ( 参见 下 一 节 )。7.1.5 节 中 的 表 7-1 将 对 不 同 的 选项 进行 比较 。 


2. 有 针对 性 地 管理 对 指定 API 的 非法 访问 
illegal-access 选项 具有 以 下 3 个 特征 : 
口 批量 管理 非法 访问 ; 
口 过 渡 性 的 选项 最 终 将 被 移 除 ; 
口 通过 警告 进行 提示 。 
当 该 选项 被 移 除 后 会 发 生 什么 ?” 强 封装 会 变 成 强制 的 吗 ? 答案 是 否定 的 。 因 为 永远 有 一 些 边 
缘 用 例 需 要 访问 (平台 和 应 用 程序 模块 的 ) 内 部 API， 所 以 需要 保留 一 些 机 制 ( 也许 不 是 最 便于 
使 用 的 那些 )， 使 这 样 的 访问 成 为 可 能 。 再 一 次 转 到 命令 行 选 项 。 


要 点 “如 7.1.3 节 讨 论 编译 过 程 中 的 内 部 API 时 所 述 ，java 命令 也 支持 --adqd- 
exports 选项 。 它 有 相同 的 工作 机 制 , 使 某 一 个 包 可 被 指定 的 模块 或 是 所 有 代码 
访问 。 这 意味 着 这 样 的 代码 可 以 使 用 这 些 包 中 公有 类 型 的 公有 成 员 ， 其 中 包括 所 

有 静态 访问 。 


NimbusLookAndFeel 类 是 公有 的 ， 所 以 要 正确 地 访问 它 ， 只 需要 导出 包含 它 的 包 。 为 了 
确保 可 以 观察 到 --adqa-exports 的 效果 ， 先 用 --illegal-access=deny 关闭 非法 访问 的 默 
认 权 限 。 


$ java 
--class-path S${class} 
--illegal-access=deny 
--add-exports java.desktop/com.sun.java.swing.plaf.nimbus=ALL-UNNAMED 
j9ms.internal.Nimbus 










































































> Static access to ${Nimbus Look and Feel} 
> Reflective access to ${Nimbus Look andq Feel} 


反射 访问 得 以 通过 。 同 时 需要 注意 ， 你 没有 收 到 警告 一 一 后 文 很 快 会 谈 到 它 。 

这 个 例子 包含 了 对 公有 类 型 的 公有 成 员 的 访问 ,但 是 反射 可 以 做 到 更 多 : 调用 
setAccessipble (true), 它 可 以 实现 与 非 公有 类 以 及 非 人 双 有 字段 、 构 造 函 数 和 方法 的 交互 。 即 
使 是 在 被 导出 的 包 中 , 这些 成 员 也 是 被 封装 的 , 所 以 要 成 功 地 对 它们 进行 反射 访问 , 还 需要 一 些 
其 他 配置 。 

--add-opens 选项 使 用 了 与 --add-exports 相同 的 语法 , 使 指定 的 包 对 反射 开放 , 这 意 
着 可 以 忽略 该 包 中 所 有 的 类 型 和 成 员 的 访问 修饰 符 一 一 它们 都 可 以 被 访问 。 因为 这 个 选项 主要 与 
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反射 相关 ， 所 以 12.2.2 节 将 正式 介绍 它 。 

这 个 选项 的 用 例 仍 然 是 访问 内 部 API， 所 以 有 必要 在 此 看 一 个 例子 。 一 个 常见 的 例子 来 自 基 
于 其 他 形式 的 表述 生成 类 实例 的 工具 ,比如 JAXB 可 以 基于 XML 文件 创建 一 个 customer 实例 。 
许多 这 样 的 类 库 依 赖 于 类 加 载 机 制 的 内 部 实现 , 通过 反射 来 访问 JDK 的 classLoader 类 的 非 公 
有 成 员 。 需要 注意 的 是 ，Oracle 有 计划 在 将 来 的 Java 版 本 中 删除 -illegal-access 选项 , 但 具 
体 是 哪 一 个 版 本 尚未 确定 。 

如 果 用 --illegal-access=deny 执行 这 样 的 代码 ， 会 得 到 一 条 错误 信息 。 

> Caused by: java.lang.reflect.InaccessibleObjectException: 


> Unable to make ClassLoader.defineClass accessible: 
> module java.base does not "opens java.lang" to unnamed module 


错误 信息 很 明确 一 一 解决 方案 是 在 启动 应 用 程序 时 使 用 --add-opens 选项 。 


$ java 
--class-path S${jars} 
--illegal-access=deny 
--add-opens java.base/java.lang=ALL-UNNAMED 
$s {main-class} 


























Es illegal-access 及 其 当前 的 默认 值 permit 不 同 ,—--add-exports 和 --add-opens 
选项 可 以 被 视 为 访问 内 部 API 的 “恰当 的 方式 ”( 或 者 某 种 意义 上 说 是 “最 合法 的 方式 ”)。 玉 
者 小 心 翼 翼 地 使 用 它们 来 满足 项 目的 需求 ， 并 且 JDK 会 对 它们 进行 长 期 支持 。 相 应 地 ， 模 块 系 
统 对 这 些 选 项 所 允许 的 访问 不 会 产生 任何 警告 。 

除 此 之 外 ， 如 果 这 两 个 选项 指定 某 个 包 是 可 访问 的 ，illegal-access 就 不 会 发 出 警告 。 
如 果 觉 得 这 些 警 告 非常 烦人 ,但 是 你 又 无 法 解决 潜在 的 问题 ， 通 过 这 种 方式 将 包 导 出 或 开放 后 ， 
这 些 警 告 就 会 被 消除 。 如 果 这 对 项 目 仍 然 不 起 作用 ( 比如 无 法 访问 命令 行 ), 看 一 下 Stack Overflow 
里 面 的 这 篇 文章 :“How to hide warning ‘Tllegal reflective access’ in Java 9 without JVM argument?”。 






































注意 如 7.1.2 节 中 所 解释 的 那样 ，JDeps 在 查找 针对 JDK 内 部 API 的 静态 访问 方面 是 
一 种 非常 优秀 的 工具 。 但 是 在 查找 反射 访问 方面 呢 ? 没有 简单 的 方式 可 以 查找 对 API 基 
于 反射 的 调用 。 但 是 对 java.lang.reflect.AccessibleObject::setAccessibl 
的 逐 级 调用 ， 或 者 对 setAccessible 的 全 文 检索 会 将 代码 中 的 大 部 分 访问 暴露 出 来 。 要 将 
项 目 作 为 一 个 整体 来 验证 ， 可 以 用 --illegal-access=debug 或 deny 运行 测试 套件 
或 者 整个 应 用 程序 ， 搜 索 出 所 有 基于 反射 的 非法 访问 。 





7.1.5 访问 内 部 API 的 编译 器 和 JVM 选 项 


在 阅读 完 本 节 后 ,你 会 获得 极 大 的 鼓舞 。 整 个 内 部 API 的 问题 表面 上 看 起 来 很 简单 ,但 是 如 
果 考 虑 到 生态 系统 的 遗留 系统 和 兼容 性 ， 问 题 就 会 变 得 稍微 复杂 些 。 表 7-1 展示 了 相关 选项 以 及 
它们 的 行为 。 
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表 7-1 对 使 人 们 在 运行 时 可 以 访问 内 部 API 的 几 种 机 制 进行 对 比 ; 按照 静态 访问 〈 直 接 基 于 这 
样 的 类 或 成 员 对 代码 进行 编译 ) 和 反射 访问 《〈 使 用 反射 API) 进行 分 类 

















































































































静态 访问 
类 或 成 员 公 有 非 公 有 

包 导 出 的 非 导出 的 导 出 的 非 导出 的 
强 封 装 v x x x 
在 Java 9 中 是 默认 行为 ， 由 于 Vv v x x 
--illegal-access=permit 
--illegal-access=warn Vv vv x x 
--illegal-access=debug vv vv x x 
--illegal-access=deny v x x x 
--add-exports v vv X X 
--add-opens v vv x x 

反射 访问 
类 或 成 员 公 有 非 公 有 

包 导 出 的 | 非 导出 的 导 出 的 非 导 出 的 
强 封装 v x x x 
在 Java 9 中 是 默认 行为 ， 由 于 v x 在 Java 9 之 前 : A 对 第 一 个 /其 他 的 Xx 
--illegal-access=permit 
--illegal-access=warn v x 在 Java 9 之 前 : A 对 所 有 的 /其 他 的 X 
--illegal-access=debug v x 在 Java9 之 前 ; 4 对 所 有 的 , 以 及 栈 跟踪 

/其 他 的 X 

--illegal-access=deny vv x x x 
--add-exports v v x x 
--add-opens vv Vv Vv vv 























除了 技术 细节 ， 为 实现 Java 9 的 兼容 性 而 将 这 些 选 项 与 其 他 选项 进行 绑 定 的 策略 也 很 重要 。 
这 是 9.1 节 将 要 讲述 的 。 如 果 不 希 望 在 命令 行 中 指定 选项 ( 比如 ， 因 为 你 正在 构建 一 个 可 执行 
JAR )， 请 仔细 阅读 9.1.4 节 ， 它 展示 了 其 他 3 种 方法 。 


7.2 ”修复 包 分 裂 


非法 访问 内 部 API. 未 解析 的 JEE 模 块 和 前 文 讨论 过 的 大 多 数 其 他 问题 虽然 制造 了 不 少 麻 烦 ， 
但 并 非 没 有 解决 的 办 法 : 它们 的 底层 概念 易于 理解 ;归功 于 精确 的 错误 信息 ,这些 问题 很 容易 识 
别 。 但 是 包 分 裂 的 情况 与 它们 完全 不 同 。 在 最 坏 的 情况 下 ， 人 们 只 能 得 到 一 种 提示 : 尽管 某 个 类 
明确 地 存在 于 类 路 径 中 的 某 个 JAR 中 ， 但 是 编译 器 或 JVM 由 于 找 不 到 某 个 类 而 抛 出 错误 。 

作为 示例 ， 现 在 看 一 下 Monitorserver 类 ， 它 使 用 了 JSR 305 的 eNonnul1l 注解 ( 如 果 从 
未 使 用 过 这 个 注解 ， 请 不 要 着 急 ， 后 文 很 快 会 介绍 它 )。 以 下 是 在 尝试 编译 它 时 出 现 的 情况 。 
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> error: cannot findq symbol 

> Symbol : class javax.annotation.Nonnull 

Ss location: class monitor.MonitorServer 

尽管 jsr305-3.0.2.jar 存在 于 类 路 径 中 ， 还 是 发 生 了 这 样 的 错误 。 

发 生 了 什么 呢 ? 为 什么 有 些 类 型 在 类 路 径 包含 它 们 的 情况 下 仍然 没有 得 到 加 载 ? 仔细 观察 ， 
就 会 发 现 有 一 点 非常 重要 : 这 些 类 型 所 在 的 包 也 存在 于 某 一 个 模块 中 。 现 在 来 研究 一 下 为 什么 会 
有 这 样 的 不 同 ， 以 及 这 种 不 同 如 何 导致 这 些 类 无 法 加 载 。 

当 不 同 的 工件 包含 相同 包 ( 导出 的 或 非 导 出 的 ) 中 的 类 时 ,它们 被 认为 是 分 裂 了 包 。 如 果 至 
少 其 中 一 个 模块 化 JAR 没有 将 该 包 导 出 ,那么 这 种 情况 也 叫 作 隐藏 式 包 冲突 。 这 些 工 件 也 许 包 
含 相同 完全 限定 类 名 的 类 ( 这 种 情况 下 的 分 裂 是 重 倒 的 )， 也 许 类 名 不 同 ， 只 共享 包 名 的 前 级 。 
不 论 包 分 裂 是 否 隐 藏 以 及 是 否 重合， 本 季 所 讨论 的 影响 都 是 相同 的 。 图 7-2 展示 了 一 个 分 裂 且 隐 
藏 的 包 。 

















another.module 


split.package 


AnotherType 





some.module 


split.package 


SomeType 


concealed.conflict 









如 果 两 个 包 中 的 其 中 一 个 
是 非 导 出 的 ， 那 么 分 裂 是 
隐藏 的 


SomeType 








overlapping.split overlapping.split 
如 果 两 个 模块 都 


类 型 ， 那 么 分 型 是 重 又 拖 
SameType 天 型 ， 那 和 分 委 SameType 


图 7-2” 当 两 个 模块 包含 同一 个 包 中 的 类 型 时 ， 它 们 分 裂 了 这 个 包 























包 分 裂 和 单元 测试 

包 分 裂 问题 是 不 单独 为 单元 测试 创建 模块 的 两 个 原因 之 一 ,通常 单元 测试 代码 被 维护 在 另 
一 棵 源 代码 树 中 ， 但 是 与 产品 代码 在 同一 个 包 中 。( 另 一 个 原因 是 强 封装 ， 因 为 单元 测试 经 常 
对 非 公 有 的 或 者 未 导出 的 类 和 方法 进行 测试 。) 


应 用 程序 服务 器 中 存在 大 量 包 分 裂 的 例子 , 它 通 常会 使 用 不 同 的 JDK 技术 。 拿 JBoss 应 用 程 
序 服务 器 以 及 jboss-jaxb-api_2.2_spec 工件 举例 。 它 包含 诸如 javax.xml .bingd.Marshaller、 
javax.xml .bind.JAXB 以 及 javax.xml .bind.JAXBException 这 样 的 类 。 这 些 类 很 明显 地 
与 java.xml.bind 模块 中 的 javax.xml .bind 包 重 合并 日 将 之 分 裂 。( 顺便 提 一 句 ，JBoss 没有 做 
错 任 何事 情 一 一 像 6.1.1 节 所 讲 的 那样 ，JAXB 是 一 项 独立 的 JEE 技术 ,该 工件 还 包含 一 套 完整 
的 实现 。) 
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一 个 非 重 等 但 问题 更 大 的 包 分 裂 的 例子 来 自 于 JSR305。Java 规范 提案 (JSR ) 305 想 将 “ 软 
件 缺 陷 检查 注解 ”引入 JDK。 它 定 义 了 一 些 注解 ,例如 eNonnull 和 eNullable,， 希望 将 它们 加 
人 javax.annotation 包 中 ; 它 还 创建 了 一 个 参考 实现 , 并 成 功 地 通过 了 Java 社区 流程 (JCP ) 
的 审核 ， 之 后 一 切 顺 利 。 那 时 是 2006 年 。 

另 一 方面 ， 社 区 很 喜欢 这 些 注 解 ， 所 以 一 些 像 FindBugs 这 样 的 静态 分 析 工 具 对 它们 进行 
了 支持 ， 而 且 很 多 项 目 采用 了 它们 。 它 们 虽然 不 是 标准 实践 , 但 在 整个 Java 生态 系统 中 得 到 了 
广泛 使 用 。 即 使 在 Java 9 中 ， 它 们 也 不 是 JDK 的 一 部 分 。 而 不 幸 的 是 ， 它 的 参考 实现 将 大 多 
数 注解 放 在 了 javax.annotation 包 中 。 这 制造 了 一 个 与 java.xml.ws.annotation 模块 的 非 重 和 至 
包 分 裂 。 


7.2.1 包 分 裂 的 问题 是 什么 


包 分 裂 出 了 什么 问题 ?” 为 什么 它 会 导致 明显 存在 的 类 无 法 被 找到 ? 这 个 问题 的 答案 并 不 是 
很 直观 。 

包 分 型 的 一 个 技术 因素 是 , Java 类 加 载 机 制 的 实现 基于 这 样 一 个 前 提 : 至 少 在 同一 个 类 加 载 顺 
中 ,任何 完全 限定 类 名 都 是 唯一 的 。 但 是 由 于 整个 应 用 程序 的 代码 在 默认 情况 下 只 有 一 个 类 加 载 器 ， 
因此 没有 有 意义 的 方法 能 够 让 这 个 需求 宽松 一 些 。 除 非 重新 设计 、 重 新 实现 Java 的 类 加 载 ， 否 则 
这 个 前 提 禁 止 重 有 的 包 分 裂 。( 13.3 节 将 展示 如 何 通过 创建 多 个 类 加 载 器 来 解决 此 问题 。) 

男 一 个 技术 因素 是 ，JDK 开发 小 组 想 利 用 模块 系统 来 改进 类 加 载 的 性 能 。6.2.1 节 描 述 了 它 
的 细节 ,大 意 是 它 需 要 了 解 每 个 包 属 于 哪个 模块 。 如 果 每 个 包 仅 属 于 一 个 单独 的 模块 ,那么 它 将 
更 加 简单 和 高 效 。 

于 是 , 包 分 裂 和 模块 系统 的 一 个 重要 目标 是 相 冲 突 的 ,这 就 是 蜂 模 块 边界 的 强 封装 。 当 不 同 
的 模块 产生 包 分 裂 时 会 发 生 什么 ”它们 不 应 该 能 够 访问 彼此 的 包 可 见 的 类 和 成 员 吗 ? 人 允许 这 样 
做 会 严重 破坏 封装 性 ; 但 不 允许 这 样 做 ,又 会 与 人 们 对 访问 修饰 符 的 理解 发 生 正面 冲突 。 在 这 方 
面 的 设计 上 ， 真 的 很 难 做 出 合适 的 决定 。 

不 过 , 也 许 最 重要 的 层面 是 概念 上 的 。 一 个 包 应 该 包含 一 个 目的 一 致 的 类 集合 ， 而 一 个 模块 
应 该 包含 一 个 (虽然 是 稍微 更 大 一 点 的 ) 目的 一 致 的 包 集合 。 从 这 个 意义 上 讲 ， 如 果 两 个 模块 中 
有 同样 的 包 ， 这 与 初 圳 是 相 违背 的 。 也 许 它 们 应 该 是 一 个 模块 ， 然 后 …… 

尽管 没有 针对 包 分 裂 的 禁止 选项 , 但 它们 具有 的 很 多 ( 人 们 不 想 要 的 ) 特性 会 导致 不 一 致 和 
歧义 。 因 此 ， 模 块 系统 对 它们 持 怀 疑 态度 ， 并 希望 阻止 它们 。 


7.2.2 包 分 裂 的 影响 


考虑 到 包 分 裂 可 能 引起 的 不 一 致 和 歧义 ， 模 块 系统 实际 上 禁止 它们 发 生 。 

D 不 允许 一 个 模块 从 两 个 不 同 的 模块 读 取 相同 的 包 。 

口 同一 层 中 的 两 个 模块 均 不 允许 包含 相同 的 包 ( 不论 是 否 已 导出 )。 

什么 是 层 ? 如 12.4 节 所 述 ， 这 是 一 个 将 类 加 载 锅 与 整个 模块 图 捆绑 在 一 起 的 容 需 。 到 目前 
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为 止 , 本 书 一 直 隐 含 地 处 于 单 层 的 情况 , 在 这 种 情况 下 第 二 个 项 目 符号 已 完全 包含 第 一 个 。 因 此 ， 
除非 涉及 不 同 的 层 ， 和 否则 包 分 裂 始 终 是 遭 到 禁止 的 。 

就 像 下 文 将 要 展示 的 那样 ,分 裂 发 生 的 位 置 不 同 , 模块 系统 的 行为 也 会 有 所 不 同 。 讨 论 完 这 
些 之 后 ， 就 可 以 开始 修复 分 裂 了 。 


1. 模块 之 间 的 分 裂 

当 两 个 模块 ( 例如 平台 模块 和 应 用 程序 模块 ) 发 生 包 分 裂 时 ,模块 系统 将 检测 到 该 情况 并 抛 
出 错误 ， 这 可 能 在 编译 时 或 运行 时 发 生 。 

举例 来 说 ， 先 研究 一 下 ServiceMonitor 应 用 程序 。 你 可 能 还 记得 ，monitor.statistics 模块 包含 
monitor.statistics 包 。 现 在 ， 在 monitor 中 创建 一 个 (同类 simplestatistician ) 具有 
相同 名 称 的 包 。 当 编译 该 模块 时 ， 会 出 现 以 下 错误 。 













































































> monitor/src/main/java/monitor/statistics/SimpleStatistician.java:1: 
> error: package exists in another module: monitor.statistics 
package monitor.statistics; 

> 

> 1 error 


当 尝 试 编译 一 个 模块 ， 而 该 模块 带 有 同样 从 必需 模块 导出 的 包 时 ， 编 译 絮 会 注意 到 该 错误 。 
但 是 当 包 没有 导出 ， 即 存在 隐藏 的 包 剖 突 时 ， 会 发 生 什么 呢 ? 
为 了 找到 答案 ， 我 向 monitor.statistics 中 添加 了 一 个 monitor.Utils 类 ， 这 意味 着 我 将 
monitor 包 分 裂 为 了 monitor 和 monitorstatistics。 这 里 的 包 分 裂 是 隐藏 的 , 因为 monitor.statistics 
并 不 导出 monitor。 

结果 有 点 令 人 惊讶 ， 在 这 种 情况 下 可 以 正常 编译 monitor。 由 于 这 种 情况 直到 运行 时 才 会 报 
告 错误 ， 因 此 当 应 用 程序 启动 时 ， 错 误 自 然 地 产生 了 。 

> Error occurred during initialization of boot layer 

> java.lang.reflect.LayerIinstantiationException: 

> Package monitor in both module monitor.statistics and module monitor 

如 果 两 个 模块 ( 两 者 都 不 需要 男 一 个 ) 包含 相同 的 包 , 那么 情况 也 是 如 此 : 在 运行 时 而 非 纺 
译 时 发 现 错误 。 


2. 模块 和 类 路 径 之 间 的 分 有 裂 

本 章 的 重点 是 在 Java 9 及 以 上 版 本 中 编译 和 运行 类 路 径 上 的 应 用 程序 ， 所 以 让 我 们 回 到 
对 应 的 用 例 上 。 有 趣 的 是 , 模块 系统 的 行为 有 所 不 同 。 类 路 径 上 的 所 有 代码 最 终 都 在 无 名 模块 (更 
多 内 容 参见 8.2 节 ) 中 ; 为 了 最 大 限度 地 提高 兼容 性 ， 一 般 来 说 ， 它 不 会 受到 仔细 检查 ， 也 不 会 
受到 与 模块 相关 的 检查 。 因 此 ， 模 块 系统 不 会 发 现 包 分 裂 ， 这 使 人 们 可 以 编译 和 启动 应 用 程序 。 

这 一 开始 听 起 来 可 能 很 棒 : 可 以 少 一 样 要 操心 的 事情 。 然 而 问题 依旧 存在 , 它 只 是 没有 那么 
明显 了 ， 所 以 最 终结 果 可 以 说 更 糟糕 了 。 

模块 系统 知道 每 个 具名 模块 〈 与 无 名 模块 相对 ): 知道 它 包 含 哪些 包 ， 并 且 每 个 包 只 属于 一 
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个 模块 。 正 如 6.2.1 节 所 解释 的 那样 ， 新 的 类 加 载 策略 受益 于 此 。 每 当 加 载 一 个 类 时 ， 类 加 载 吉 
会 查找 包含 该 包 的 模块 并 尝试 从 中 加 载 。 如 果 它 包含 所 需 的 类 ， 那 很 好 ; 如 果 不 包 含 ， 则 抛 出 
NoClassDefFoundErroro 

如 果 模 块 和 类 路 径 之 间 存 在 包 分 裂 , 那么 类 加 载 器 将 始终 并 且 只 在 从 该 包 加 载 类 时 查看 对 应 
的 模块 ( 如 图 7-3 所 示 )。 





如 果 映 射 关系 中 包 
含 需 要 的 包 名 ， 那 
么 JPMS 会 尝试 从 该 
模块 中 加 载 不 论 它 是 否 发 现 了 类 ， 
类 路 径 都 不 会 被 检查 
加 载 org.company .Thing 










包 > 模块 
映射 

二 

ESRCCIUSSTNTE > 











org.company 包 
7-3 ”类 路 径 内 容 未 暴露 给 模块 检查 ， 并 且 其 中 的 包 未 被 索引 。 如 果 它 与 某 模块 之 间 存 
在 包 分 裂 ， 类 加 载 器 只 会 知道 那个 模块 并 从 中 查找 所 需 的 类 。 此 图 中 类 加 载 器 寻 

找 org.company 并 检查 相应 的 模块 ， 同 时 忽略 包 在 类 路 径 上 的 部 分 


在 类 路 径 那 部 分 包 中 的 类 实际 上 是 不 可 见 的 ! 这 不 仅 适 用 于 平台 模块 和 类 路 径 之 间 的 包 分 
， 在 应 用 程序 模块 〈( 即 从 模块 路 径 加 载 的 JAR ) 和 类 路 径 之 间 也 是 如 此 。 

是 的 ， 你 的 理解 是 正确 的 。 如 果 某 些 代码 包含 来 自 javax.annotation 包 的 类 ， 那 么 类 加 
载 右 将 查看 唯一 含有 该 包 的 模块 ，java.xml.ws.annotation。 如 果 找 不 到 对 应 的 类 ， 则 会 殷 出 
NoClassDefFoundError， 即 使 该 类 存在 于 类 路 径 上 也 是 如 此 。 

可 以 想象 , 莫名 缺失 的 类 可 能 会 导致 一 些 令 人 头疼 的 问题 。 这 也 正 是 可 能 造成 包 分裂 问 题 的 
JEE 模块 在 默认 情况 下 不 会 受到 解析 的 原因 (6.1 节 已 详细 解释 过 )。 尽 管 如 此 ， 这 些 模块 仍 可 造 
成 最 奇怪 的 包 分 裂 案例 。 

考虑 一 个 使 用 aGenerated 注解 和 eNonnul1 注解 的 项 目 ， 其 中 ， 前 者 出 现在 Java 8 中 ， 后 者 
是 项 目 在 类 路 径 上 的 JSR 305 实现 , 两 者 都 在 javax.annotation 包 中 。 这 种 情况 下 , 在 Java9 
及 以 上 版 本 中 进行 编译 会 发 生 什么 ? 

> error: cannot fingd Symbol 


> symbol: class Generated 
> location: package javax.annotation 














汇 

















这 是 因为 缺少 Java 类 吗 ? 是 的 ， 因 为 该 类 属于 JEE 模块 java.xml.ws.annotation， 在 默认 情 
况 下 不 会 受到 解析 。 但 错误 信息 有 所 不 同 : 它 没有 提示 解决 方案 。 幸 好 ， 前 文 提 到 可 以 使 用 
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--add-modules java.xml.ws.annotation 选项 ,添加 包含 它 的 模块 ， 解 决 此 问题 。 于 是 得 
到 如 下 结果 。 
> error: cannot findq symbol 


Ss symbol: class Nonnull 
各 location: class MonitorServer 











编译 带 之 前 发 现 了 这 个 类 , 为 什么 现在 反而 发 现 不 了 ?因为 现在 有 一 个 含有 javax.annotation 
包 的 模块 ， 所 以 类 路 径 上 的 部 分 变 得 不 可 见 了 。 
重复 一 遍 如 下 〈 图 7-4 中 也 可 以 看 到 )。 
口 第 一 个 错误 是 JEE 模块 默认 无 法 解析 引起 的 。 
口 第 二 个 错误 是 模块 系统 忽略 包 分 裂 的 类 路 径 部 分 引起 的 。 


























java.xml.ws.annotation 包 仿 
@Generated 但 无 &Nonnull 
包 未 被 索引 所 以 加 载 失败 











从 javax.annotation 中 


从 javax.annotation 中 
加 载 &Generated 


加 载 aNonnul1 





国 国 
国 0 
OO@@ 国 国 
oh Se 类 路 径 未 被 检查 en 
包含 seGenerated， 


所 以 加 载 失 败 
图 7-4 从 同一 个 包 中 加 载 会 由 于 不 同 的 原因 而 失败 。 如 左 侧 所 示 ， 未 手动 添加 JEE 模块 
java.xmlws.annotation， 因 此 G6Generateqd 加 载 失败 ， 因 为 类 路 径 上 的 JSR305 工件 未 
包含 它 。 如 右 侧 所 示 , 在 添加 了 模块 后 , 将 从 该 模块 加 载 所 有 的 javax.annotation 
里 的 类 ， 即 使 eNonnul1l 也 是 如 此 ， 然 而 只 有 JSR 305 包含 它 。 最 终 ， 两 种 方案 都 导 
致 所 需 的 注解 加 载 失败 


这 就 说 得 通 了 。( 对 吗 ? ) 既然 你 已 经 对 此 有 了 全 面 的 了 解 ， 现 在 看 看 如 何 解决 此 问题 。 
7.2.3 处理 包 分 裂 的 多 种 方法 


有 很 多 方法 可 以 让 包 分 裂 正 常 工作 。 这 里 按照 推荐 顺序 一 一 介绍 : 
口 重 命 名 其 中 一 个 包 ; 

口 将 包 分 裂 的 所 有 部 分 移 到 同一 个 工件 中 ; 

口 合并 工件 ; 






































口 把 两 个 工件 都 放置 在 类 路 径 上 ; 
口 基于 工件 升级 JDK 模块 ; 
口 利用 工件 的 内 容 扩展 已 有 模块 。 


注意 ”在 迁移 期 间 ， 只 有 最 后 两 种 方法 适用 于 典型 的 包 分 裂 场 景 ， 即 平台 模块 和 类 路 径 
上 的 工件 之 间 的 包 分 裂 。 


第 一 种 方法 适用 于 包 名 称 冲 突 是 偶然 现象 的 情况 。 它 应 该 是 最 明显 的 选择 , 请 尽量 采用 此 方 
案 。 当 包 分 列 是 有 意 的 时 ， 这 种 方法 就 不 太 可 行 了 。 如 果 那 样 ， 可 以 尝试 通过 移动 几 个 类 或 者 合 
并 工件 进行 修复 。 前 3 个 选项 都 是 最 合理 的 长 期 解决 方案 , 但 显然 只 在 你 有 控制 包 分 裂 的 工件 时 
才 有 效 。 

如 果 与 包 分 裂 相关 的 代码 不 属于 你 , 或 者 前 3 个 解决 方案 不 适用 ， 就 需要 启用 其 他 选项 , 使 
模块 系统 在 分 裂 的 包 依然 存在 的 情况 下 正常 工作 ,一 个 较为 直观 的 解决 方案 是 将 两 个 工件 都 保留 
在 类 路 径 上 , 被 捆绑 进 同 一 个 无 名 模块 中 ， 其 最 终 行为 与 Java 9 之 前 版 本 相同 。 这 是 一 个 有 效 的 
中 间 策 略 ， 在 详细 讨论 处 理 方案 之 前 ， 可 以 先 使 用 这 个 方案 进行 修复 。 

很 遗憾 ， 到 目前 为 止 讨论 的 所 有 解决 方案 都 不 适用 于 涉及 JDK 模块 的 包 分 裂 ， 因 为 你 无 法 
直接 控制 JDK。 要 克服 这 个 问题 ,就 需要 更 强大 的 武器 。 如 果 你 足够 幸运 ,发 生 包 分 裂 的 工件 不 
仅 含 有 随机 的 JDK 包 中 的 一 些 类 ， 还 提供 了 可 升级 的 JDK 模块 的 完整 替代 品 。 在 这 种 情况 下 ， 
请 阅读 6.1.3 节 ， 其 中 介绍 了 如 何 使 用 --upgrade-module-path 选项 。 

如 果 以 上 方案 都 没有 作用 ， 那 么 只 能 使 用 最 后 的 且 最 极 客 的 方案 : 扩展 已 有 模块 。 


7.2.4 扩展 模块 : 处 理 包 分 裂 的 最 后 手段 


这 是 一 种 几乎 可 以 修复 所 有 包 分 裂 问题 的 技术 ， 但 该 技术 始终 应 该 作为 最 后 万 不 得 已 的 手 
段 。 它 可 以 使 模块 系统 假装 认为 ,类 路 径 上 那些 烦人 的 类 属于 含有 分 裂 包 的 模块 。 编译 器 和 运行 
时 选项 --patch-module ss{module}=${artifact}) 会 将 s{tartifact} 里 的 所 有 类 合并 到 
$ {module} 中 。 这 里 仍 有 一 些 需 要 注意 的 事项 ， 但 在 此 之 前 先 看 一 个 例子 。 

前 文 展示 了 使 用 注解 ecenerated( 来 自 java.xml.ws.annotation 模块 ) 和 @Nonnu1l1( 来 自 JSR 
305 实现 ) 的 项 目 示 例 。 它 说 明了 3 件 事 : 
口 因为 两 个 注解 都 位 于 javax.annotation 包 中 ， 所 以 产生 了 包 分 裂 ; 
口 人 们 需要 手动 添加 模块 ， 因 为 它 是 JEE 模块 ; 
口 手动 添加 模块 会 导致 包 分 裂 JSR 305 的 部 分 变 得 不 可 见 。 
现在 你 知道 可 以 使 用 --patch-module 来 修复 包 分 裂 。 


javac 
--add-modules java.xml .ws.annotation 
--patch-module java.xml .ws.annotation=jsr305-3.0.2.jar 
--class-path 'libs/*' 
-d classes/monitor.rest 
$s{source-files} 
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这 样 , jsr305-3.0.2.jar 中 的 所 有 类 都 成 了 模块 java.xml.ws.annotation 的 一 部 分 , 可 以 被 
加 载 ， 并 最 终 得 到 成 功 编译 ( 或 者 可 以 用 java 命令 执行 )。 真 棒 ! 

有 几 点 需要 注意 。 首 先 , 扩展 模块 不 会 自动 添加 到 模块 图 中 。 如 果 没 有 明确 要 求 ， 可 能 仍 需 
要 使 用 --add-modules 选项 (参见 3.4.3 问 。 
























4 














接 下 来 , 使 用 --patch-module 选项 添加 到 模块 中 的 类 遵循 一 般 可 访问 性 规则 (参见 3.3 节 
这 些 类 
口 同样 ， 这 些 类 的 依赖 需要 存在 于 被 扩展 模块 读 取 的 模块 已 导出 的 包 中 。 
加 上 ， 这 大 部 分 时 候 通 过 --add 
ES -B 的 模块 ， 这 可 以 通过 --adqd- 
一 六 以 这 些 边 需要 被 加 上 ， 这 大 部 


和 图 7-5 )。 
依赖 于 模块 B 中 类 的 模块 不 一 定 
BEDS | BED | A 
% S me 模块 A 必须 导出 模块 B 中 的 公 
xports 实 现 
有 分 时 候 通 过 --add-reads 实 现 
借助 --patch-module A=B.jar,， 


口 依赖 于 的 代码 需要 读 取 扩 展 的 模块 ， 该 模块 必须 导出 所 需 的 包 。 
读 取 模块 A， 所 以 这 些 边 需 要 被 
C 6 API， 所 以 它 需 要 能 够 访问 依赖 
块 人 通常 不 读 取 模块 B 的 依赖 ， 
扩展 前 的 A 和 B 的 模块 图 模块 A 包 含 了 模块 B 中 的 类 ， 但 是 惫 











被 称 为 A 











图 7-5 ”如 果 将 模块 中 的 类 扩展 到 男 一 个 模块 ( 此 处 为 模块 B 到 模块 A )， 必 须 手 动 编 
辑 已 扩展 模块 的 传人 和 传 出 依赖 以 及 导出 包 才能 使 包含 的 类 正常 工作 

此 处 可 能 需要 使 用 命令 行 选项 来 操作 模块 图 , 例如 --add-reads (参见 3.4.4 节 ) 和 --aaa- 
exports (参见 11.3.4 节 ) 由 于 具名 模块 无 法 访问 类 路 径 中 的 代码 ， 因 此 可 能 还 需要 创建 一 些 
自动 模块 (参见 83 欧 。 


7.2.5 ”使 用 JDeps 查 找 分 裂 的 包 


通过 反复 试 错 寻找 分 裂 的 包 是 一 项 乏味 的 工作 ， 幸 和 运 的 是 ，JDeps 会 报告 分 裂 的 包 。 附 录 D 
对 该 工具 进行 了 概述 。 了 解 概述 即 可 ， 因 为 几乎 任何 输出 都 包含 包 分 裂 的 详细 信息 。 

现在 看 看 JDeps 报告 示例 : 应 用 程序 使 用 了 来 自 java.xml.ws.annotation 的 javax.annotation . 
Generated 和 来 自 JSR 305 的 javax.annotation.Nonnull 注解 。 在 把 所 有 的 依赖 复制 到 lib 
目录 之 后 ， 可 以 按照 如 下 方式 执行 JDeps。 


$ jdeps -summary 
-recursive --class-path 'libs/*' project.jar 























split package: javax.annotation 
[jrt:/java.xml .ws.annotation, libs/jsr305-3.0.2.jar] 


以 下 省 略 了 更 多 的 项 目 依赖 
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结果 很 明确 ， 对 吧 ? 如 果 好 奇 什 么 依赖 于 分 裂 的 包 ， 你 可 以 使 用 --package 和 -verbose: 
class 选项 。 


$ jdeps -verbose:class 
--package javax.annotation 
-recursive --class-path 'libs/*' project.jar 


# 省 略 了 分 裂 的 包 
# 省 略 了 来 自 javax.annotation 的 依赖 


> rest-1.0-SNAPSHOT.jar -> libs/jsr305-3.0.2.jar 
> monitor.rest.MonitorServer -> Nonnull jsr305-3.0.2.jar 


7.2.6 ”关于 依赖 版 本 冲突 的 说 明 


如 1.3.3 节 所 述 ，Java 8 对 同时 运行 的 同一 个 JAR 的 多 个 版 本 (例如 应 用 程序 同时 传递 地 依 
赖 于 Guava 19 和 Guava 20 ) 没有 开 箱 即 用 的 支持 。 之 后 ，1.6.6 节 指 出 ， 模 块 系统 并 不 会 改善 这 
一 行为 。 在 阅读 了 前 文 关 于 包 分 裂 的 讨论 后 ， 你 应 该 清楚 为 什么 会 这 样 。 

Java 模块 系统 改变 了 类 加 载 策略 〈 查 看 特定 的 模块 代替 了 扫描 类 路 径 )， 但 它 没有 改变 基本 
的 假设 和 机 制 。 每 个 类 加 载 器 仍然 只 能 接受 一 个 具有 相同 完全 限定 类 名 的 类 , 即 同 一 工件 的 多 个 
版 本 不 可 能 同时 使 用 。 模 块 系统 对 版 本 支持 的 更 多 详细 信息 ， 可 以 参见 第 13 章 。 


提示 “你 已 经 了 解 了 所 有 常见 的 和 一 些 不 常见 的 迁移 挑战 。 如 果 渴 望 将 所 学 知识 付 诸 实 
践 并 将 项 目 升级 到 Java9 及 以 上 版 本 ,请 直接 跳 到 第 9 章 (讨论 了 解决 这 个 问题 的 最 好 
方法 ),。 一 旦 应 用 程序 在 Java9 及 以 上 版 本 中 运行 ,你 就 可 以 利用 jlink 基于 所 需 模 块 
来 定制 运行 时 镜像 一 参见 14.1 节 。 如 果 你 对 接 下 来 的 步骤 , 即 把 现 有 代码 库 转 化 为 模 
块 感 兴趣 ， 请 阅读 第 8 章 。 

















7.3 ”小结 


口 如 果 想 知道 在 模块 系统 下 项 目 中 的 类 如 何 得 到 访问 ， 那 么 了 解 在 模块 系统 的 新 时 代 下 它 

们 是 如 何 组 织 的 非常 重要 。 

java.* 包 和 javax.* 包 中 的 所 有 公有 类 都 是 标准 化 的 。 这 些 包 由 java.* 模 块 导出 ， 可 
以 被 安全 地 依赖 ， 因 此 不 需要 进行 任何 更 改 。 

和 com.sun.x* 包 中 的 公有 类 由 Oracle 提供 支持 。 这 些 包 由 jdk.* 模 块 导出 ， 因 此 能 否 继续 
依赖 它们 ， 受 限于 提供 代码 库 的 JDK 供应 商 。 

和 Sun .x* 包 中 的 一 些 可 选择 的 类 暂时 由 Oracle 提供 支持 ， 直 到 未 来 的 Java 版 本 引入 相应 
的 替代 者 。 它 们 由 jdk-unsupported 模块 导出 。 

@ 所 有 其 他 类 都 不 受 支 持 且 无 法 访问 。 想 使 用 它们 只 能 通过 命令 行 标 志 ， 但 如 果 这 样 做 ， 
那 代 码 可 能 无 法 在 不 同 小 版 本 或 不 同 供应 商 的 JVM 上 运行 。 因 此 ， 通 常情 况 下 ， 本 书 
不 建议 这 么 做 。 
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口 有些 内 部 API 已 经 遭 到 删除 ， 因 此 即使 借助 命令 行 选 项 也 没有 办 法 继续 使 用 它们 。 

口 虽然 强 封 装 通常 禁止 访问 内 部 API， 但 是 有 一 个 例外 : 访问 JDK 内 部 API 的 类 路 径 上 的 
代码 。 这 可 以 大 大 简化 迁移 过 程 ， 也 会 使 模块 系统 的 行为 变 得 复杂 。 

在 编译 期 间 ， 强 封装 完全 处 于 活动 状态 ， 阻 止 对 JDK 内 部 API 的 访问 。 但 是 ， 如 果 需 

要 某 些 API， 可 以 使 用 --add-exports 授予 访问 权限 。 
@ 在 运行 时 ,默认 情况 下 Java9 到 Java 11 允许 对 未 导出 的 JDK 包 中 的 公有 类 进行 静态 访 
问 。 这 使 得 现 有 应 用 程序 更 有 可 能 开 箱 即 用 ,但 将 来 的 版 本 中 这 可 能 会 发 生变 化 。 

a 在 默认 情况 下 ,可 以 对 所 有 JDK 内 部 API 进行 反射 访问 , 但 在 首次 访问 包 ( 默认 行为 ) 
或 每 次 访问 时 (使 用 --illegal-access=warn ) 会 发 出 警告 。 分 析 它 的 最 佳 方法 是 使 
用 --illegal-access=debug， 这 样 每 个 警告 中 都 将 包含 栈 跟 踪 的 详细 信息 。 

只 要 指定 --illegal-access=deny 选项 ， 同 时 在 必要 时 使 用 --add-exports 和 

--add-opens 访问 严格 依赖 的 包 ， 就 可 以 更 加 严格 地 限制 静态 和 反射 访问 。 尽 早 实现 

该 目标 可 以 更 轻松 地 迁移 到 未 来 的 Java 版 本 。 

口 模块 系统 禁止 〈 同 一 层 中 的 ) 两 个 模块 含有 相同 的 包 ， 并 且 不 论 包 导出 与 否 都 是 如 此 。 
但 这 并 不 是 为 了 检查 类 路 径 上 的 代码 ， 所 以 平台 模块 和 类 路 径 代 码 之 间 存 在 未 发 现 的 包 
分 裂 是 有 可 能 的 。 

口 如 果 在 模块 和 类 路 径 之 间 存 在 包 分 裂 ， 那 么 类 路 径 上 的 部 分 基本 是 不 可 见 的 。 这 会 导致 
令 人 惊讶 的 编译 时 和 运行 时 错误 。 最 好 的 解决 方案 是 移 除 分 裂 的 包 ， 如 果 做 不 到 ， 可 以 
考虑 借助 --upgrade-module-path (如 果 它 是 可 升级 的 模块 ) 用 包 分 裂 的 工件 来 升级 

替换 原 有 的 模块 ， 或 者 使 用 - -patch-modaule 扩展 其 内 容 。 
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本 章 内 容 

口 处 理 无 名 模块 

口 借助 自动 模块 进行 模块 化 
口 增 量 模块 化 代码 库 

口 混搭 类 路 径 和 模块 路 径 








根据 向 Java 9 及 以 上 版 本 迁移 的 顺利 程度 〈 参 见 第 6 章 和 第 7 章 )， 在 向 一 个 有 一 定年 头 的 
生态 系统 引入 模块 系统 并 让 其 正常 工作 的 过 程 中 , 你 可 能 会 遇 到 一 些 比较 麻烦 的 问题 。 好 消息 是 
这 样 做 是 值得 的 ! 正如 1.7.1 节 简 单 介绍 的 那样 ，Java 9 及 以 上 版 本 除了 模块 系统 外 还 有 很 多 其 
他 功能 。 如 果 你 的 项 目 支持 Java 9， 就 可 以 立即 使 用 这 些 功 能 。 

最 终 , 你 还 可 以 将 项 目 模块 化 。 通过 将 工件 转化 为 模块 化 JAR, 你 和 你 的 用 户 可 以 受益 于 可 
靠 配 置 (参见 3.2.1 节 )、 强 封装 〈 参 见 3.3.1 节 )、 用 服务 来 解 耦 模块 〈 人 参见 第 10 章 )、 运 行 时 镜 
像 (包括 整个 应 用 程序 的 运行 时 镜像 ,参见 14.2 节 )， 以 及 与 模块 相关 的 许多 其 他 优点 。 如 9.3.4 
节 所 述 ， 你 其 至 可 以 对 运行 在 Java 8 及 更 早 版 本 中 的 项 目 进行 模块 化 。 
模块 化 JAR 有 两 种 方法 : 

口 在 所 有 的 依赖 都 被 模块 化 后 ， 统 一 为 所 有 的 工件 创建 模块 描述 符 ; 
口 先 对 一 部 分 工件 进行 模块 化 〈 可 能 一 次 只 有 几 个 ) 

结合 第 3 章 、 第 4 童 和 第 5 章 所 讨论 的 内 容 , 第 一 种 方案 比较 直截了当 。 你 可 能 还 需要 第 10 
章 和 第 11 章 介绍 的 一 些 更 高 级 的 模块 系统 功能 ， 但 除 此 之 外 ， 你 可 以 放心 继续 进行 : 为 正在 构 
建 的 每 个 工件 创建 一 个 模块 声明 ， 并 用 之 前 所 学 的 知识 为 它们 的 关系 建 模 。 

也 许 你 的 项 目 位 于 一 棵 层级 很 深 的 依赖 树 之 上 , 你 不 想 等 待 所 有 依赖 都 完成 模块 化 。 或 者 你 
的 项 目 太 大 ,以 至 于 无 法 一 口气 将 所 有 的 工件 都 转化 为 模块 。 在 这 些 情况 下 ,你 可 能 会 倾向 于 第 
二 个 选项 ， 即 对 工件 进行 增 量 模块 化 ， 而 不 管 它 们 依赖 的 是 模块 化 JAR 还 是 普通 JAR。 

能 够 同时 使 用 模块 化 工件 和 部 分 模块 化 工件 不 仅 对 各 个 项 目 非常 重要 , 还 意味 着 整个 生态 系 
统 可 以 彼此 独立 地 包含 模块 。 否则 , 整个 生态 系统 的 模块 化 可 能 要 花费 数 十 年 的 时 间 一 一 只 有 这 
样 ， 每 个 人 才能 在 可 控 时 间 内 完成 模块 化 工作 。 

本 章 将 介绍 一 些 特性 , 借助 这 些 特性 可 以 实现 对 现 有 项 目的 增 量 模块 化 。 我 们 将 首先 讨论 类 

























































































150 第 8 章 增 量 模块 化 现 有 项 目 














路 径 和 模块 路 径 的 组 合 , 接着 检测 无 名 模块 , 然后 通过 查看 自动 模块 进行 总 结 。 完成 以 上 动作 后 ， 
尽管 可 能 存在 部 分 模块 化 的 依赖 关系 , 但 你 的 项 目 或 项 目的 一 部 分 仍 将 从 模块 系统 中 受益 。 你 还 
将 为 第 9 章 做 好 准备 ， 该 章 讨论 了 模块 化 应 用 程序 的 策略 。 


8.1 为 什么 选择 增 量 模块 化 


在 讨论 如 何 增 量 模块 化 项 目 之 前 , 先 来 思考 一 下 为 什么 这 是 一 个 可 选项 。 模块 系统 通常 要 求 
所 有 内 容 都 是 模块 。 但 是 ,如果 出 现 得 太 晚 ( 比如 JPMS ), 或 仅 被 生态 系统 的 某 一 小 部 分 所 使 用 
(比如 OSGi 或 JBoss 模块 )， 那么 现实 肯定 不 能 像 理论 一 样 完美 。 因 此 ， 人 们 必须 找到 一 种 与 部 
分 模块 化 工件 交互 的 方法 。 

在 本 节 中 ， 首 先 要 考虑 如 果 每 个 JAR 都 必须 模块 化 才能 在 Java 9 及 以 上 版 本 中 运行 ， 会 发 
生 什 么 情况 ， 从 而 得 出 必须 将 普通 JAR 和 模块 化 JAR 混搭 运行 的 结论 ( 参见 8.1.2 节 )。 然 后 本 
节 将 展示 如 何 并 行使 用 类 路 径 和 模块 路 径 ， 以 实现 这 种 混搭 运行 方法 ( 参见 8.1.3 欧 。 


8.1.1 如 果 每 个 JAR 都 必须 是 模块 化 的 …… 


如 果 JPMS 非常 严格 , 要 求 所 有 内 容 都 必须 是 模块 , 那么 只 有 在 所 有 JAR 都 包含 模块 描述 符 
时 才能 使 用 它 。 而 且 由 于 模块 系统 是 Java 9 及 以 上 版 本 不 可 或 缺 的 一 部 分 ， 由 此 可 推论 ， 如 果 不 
对 所 有 代码 和 依赖 进行 模块 化 ， 你 甚至 无 法 升级 到 该 版 本 。 想 象 一 下 ， 如 果真 是 这 样 的 话 ， 后 果 
会 如 何 ? 

有 些 项 目 可 能 会 早早 更 新 到 Java 9 及 以 上 版 本 , 迫使 项 目的 所 有 用 户 将 自己 的 代码 库 模 块 化 
或 停止 使 用 该 项 目 。 而 男 一 些 项 目 可 能 不 想 被 迫 做 出 决定 ， 或 者 由 于 其 他 原因 不 想 迈 出 这 一 步 ， 
而 这 些 都 会 阻碍 用 户 的 更 新 。 如 果 我 不 希望 项 目 中 有 决策 不 一 致 的 依赖 项 ， 那 该 怎么 办 ? 

此 外 ,一些 项 目 也 许 会 分 别 发 布 附带 模块 描述 符 和 不 带 模块 描述 符 的 版 本 , 并 将 其 提供 给 用 
户 , 因此 他 们 不 得 不 使 用 两 个 完全 不 相交 的 依赖 关系 集 ( 一 个 带 有 模块 描述 符 ， 男 一 个 不 带 模块 
描述 符 )。 此 外 ， 除 非 它们 向 后 兼容 旧 的 主要 版 本 和 次 要 版 本 ， 否 则 为 了 跳 转 到 Java 9 及 以 上 版 
本 ,用 户 将 被 迫 一 次 执行 很 多 ( 可 能 很 耗 时 的 ) 更 新 。 而 且 ,， 这 还 没有 考虑 那些 不 再 受到 维护 的 
项 目 。 即 使 本 身 没 有 任何 依赖 ， 这 些 项 目 也 将 很 快 在 Java 9 及 以 上 版 本 中 变 得 不 可 用 。 
一 避免 前 功 尽 弃 和 彻底 分 裂 的 方法 , 就 是 等 待 整个 生态 系统 上 的 每 一 个 项 目 都 更 新 到 Java 9 
及 以 上 版 本 , 并且 发 布 模块 化 的 JAR。 但 是 这 一 定 行 不 通 。 并 且 , 无 论 通过 哪 种 方式 对 依赖 进行 
分 割 ， 任何 执行 某 个 JAR 的 人 都 必须 知道 该 JAR 是 为 哪个 Java 版 本 创建 的 ,否则 该 JAR 无 法 在 
Java 8 和 Java 9 中 和 运行。 总而言之 ， 人 们 会 遇 到 巨大 的 麻烦 ! 


8.1.2 ”让 普通 JAR 和 模块 化 JAR 混 搭 


为 了 避免 上 述 麻 烦 ， 模 块 系统 必须 提供 一 种 在 模块 化 JVM 上 运行 部 分 模块 化 代码 的 方法 。 
第 6 章 的 引言 解释 了 模块 系统 确实 如 此 : 类 路 径 上 普通 JAR 的 工作 方式 和 Java 9 之 前 版 本 一 样 
( 如 第 6 章 和 第 7 章 所 述 ， 它 们 包含 的 代码 可 能 无 法 运行 ， 但 这 是 另 一 回 事 )。8.2 节 将 详细 说 明 
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类 路 径 模式 的 工作 方式 。 

仅仅 知道 它 的 工作 原理 就 已 经 是 一 条 重要 的 启示 : 模块 系统 可 以 正确 处 理 部 分 模块 化 的 工 
件 , 并 且 知 道 如 何 定位 它们 与 清晰 模块 之 间 的 边界 。 这 是 个 好 消息 ， 而 且 不 止 于 此 : 该 边界 不 是 
一 成 不 变 的 。 因此, 不 必 将 应 用 程序 JAR 与 JVM 模块 分 开 。 本章 其 余部 分 将 继续 对 此 进行 探讨 。 
模块 系统 让 你 可 以 移动 该 边界 ， 并 根据 项 目 需要 将 模块 化 和 部 分 模块 化 的 应 用 程序 JAR 与 平台 
模块 混搭 ， 如 图 8-1 所 示 。 











更 多 的 JAR 被 模块 化 后 ， 
普通 JAR 和 模块 化 JAR 
之 加 的 边界 被 移动 了 


C0 , 1 i ， 1 
a TE (Te 


模块 化 JAR 或 平台 模块 






























模块 化 JAR 或 平台 模块 


图 8-1 模块 系统 允许 部 分 模块 化 代码 在 模块 化 的 JDK 上 运行 ( 左 )。 更 重要 的 是 ， 它 为 你 
提供 了 移动 该 边界 的 工具 ( 右 ) 




















8.1.3” 增 量 模块 化 的 技术 基础 


使 增 量 模块 化 成 为 可 能 的 基本 原理 是 类 路 径 和 模块 路 径 可 以 并 行使 用 。 无须 一 次 性 将 所 有 的 
应 用 程序 JAR 从 类 路 径 移 至 模块 路 径 ， 取 而 代 之 的 是 ， 鼓 励 现 有 项 目 从 类 路 径 开 始 ， 随 着 模块 
化 工作 的 进行 ， 将 其 工件 缓慢 地 移 至 模块 路 径 。 

同时 在 两 种 路 径 上 使 用 普通 JAR 和 模块 化 JAR 需要 对 这 些 概念 之 间 的 关系 有 一 个 清晰 的 了 
解 。 你 可 能 会 认为 缺少 模块 描述 符 的 JAR 应 该 在 类 路 径 上 运行 ， 而 模块 化 JAR 应 该 在 模块 路 径 
上 运行 。 尽管 前 文 从 来 没有 这 样 提 过 ,但 你 可 能 会 因为 字里行间 的 “暗示 ”产生 这 个 理论 。 不 管 
怎样 ， 这 个 理论 是 错误 的 ， 是 时 候 忘 记 它 了 。 

以 下 两 种 机 制 使 该 理论 无 效 ， 并 且 使 增 量 模块 化 成 为 可 能 。 
口 无 名 模块 被 模块 系统 隐 式 地 创建 并 包含 了 从 类 路 径 中 加 载 的 所 有 内 容 ， 其 中 ， 类 路 径 上 
的 混乱 依旧 存在 ( 8.2 节 将 详细 说 明 )。 
口 自动 模块 由 模块 系统 为 在 模块 路 径 上 找到 的 每 个 普通 JAR 创建 ( 8.3 节 将 专门 讨论 此 概念 )。 

类 路 径 对 普通 JAR 和 模块 化 JAR 不 做 任何 区 分 : 它们 只 要 在 类 路 径 上 ， 最 终 都 会 变 成 无 名 
模块 。 同 样 ， 模 块 路 径 对 于 普通 JAR 和 模块 化 JAR 也 不 做 任何 区 分 : 它们 只 要 在 模块 路 径 上 ， 
最 终 都 会 变 成 自己 的 具名 模块 ( 针对 普通 JAR, 模块 系统 将 创建 一 个 自动 模块 ; 针对 模块 化 JAR， 
模块 系统 将 根据 模块 描述 符 创建 一 个 清晰 模块 )。 

要 理解 本 章 其 余部 分 并 开始 进行 模块 化 ， 完 全 掌握 模块 化 内 部 的 行为 是 非常 重要 的 。 表 8-1 
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展示 了 一 个 二 维 表格 ， 从 中 可 以 看 出 ，JAR 是 否 成 为 无 名 模块 或 具名 模块 的 一 部 分 不 由 JAR 的 
类 型 ( 普通 或 模块 化 ) 决定 ， 而 由 其 所 放置 的 路 径 ( 类 路 径 或 模块 路 径 ) 决定 。 


表 8-1 JAR 是 否 成 为 无 名 模块 或 具名 模块 的 一 部 分 不 由 JAR 的 类 型 决定 ， 而 由 其 所 放置 的 路 径 决定 























类 路 径 模块 路 径 
普通 JAR 无 名 模块 (参见 8.2 节 ) 动 模块 (参见 8.3 节 ) 
模块 化 JAR 清晰 模块 ( 参见 3.1.4 节 ) 


当 决 定 是 将 JAR 放 在 类 路 径 上 还 是 放 在 模块 路 径 上 时 , 与 代码 的 来 源 无 关 , ( 和 JAR 是 否 模 
块 化 有 关 吗 ? ) 但 与 你 需要 将 代码 放 在 哪里 有 关 ( 在 无 名 模块 或 具名 模块 中 )。 如 果 和 希望 代码 进 
入 “大 泥 球 ”， 可 以 使 用 类 路 径 ; 如 果 和 希望 代码 成 为 模块 ， 可 以 使 用 模块 路 径 。 

但 是 ,如 何 确定 把 代码 放 在 哪里 呢 ? 通用 准则 是 : 无 名 模块 与 兼容 性 相关 ,可 以 让 使 用 类 路 
径 的 项 目 在 Java 9 及 以 上 版 本 中 运行 ; 自动 模块 与 模块 化 相关 , 它 使 项 目 在 依赖 尚未 模块 化 的 情 
况 下 也 可 以 使 用 模块 系统 。 

如 果 想 知道 更 详细 的 答案 , 可 以 仔细 研究 一 下 无 名 模块 和 自动 模块 。 第 9 章 将 定义 更 广泛 的 
模块 化 策略 。 同 时 ， 如 果 想 知道 现 有 项 目 是 否 值得 进行 模块 化 ， 可 以 参见 15.2.1 节 。 

会 


注意 尽管 构建 工具 可 能 会 帮 你 做 出 很 多 决定 .但 是 ,你 最 终 仍然 有 可 能 遇 到 一 些 问题 。 
在 这 种 情况 下 ， 可 以 应 用 本 章 中 探讨 的 内 容 来 对 构建 进行 正确 配置 。 













































































8.2 无 名 模块 “类 路 径 ) 


有 一 个 方面 本 书 还 没有 详细 解释 : 模块 系统 和 类 路 径 是 如 何 一 起 工作 的 ? 本 书 第 一 部 分 清晰 
地 介绍 了 模块 化 应 用 程序 如 何 将 所 有 内 容 放置 在 模块 路 径 上 并 在 模块 化 JDK 上 运行 。 接 着, 第 6 
章 和 第 7 章 阐述 了 如 何 编译 部 分 模块 化 代码 并 从 类 路 径 中 运行 应 用 程序 。 但 是 类 路 径 上 的 内 容 是 
如 何 与 模块 系统 交互 的 ? 处 理 了 哪些 模块 ? 是 如 何 解决 的 ? 为 什么 类 路 径 上 的 内 容 可 以 访问 所 
有 平台 模块 ?无 名 模块 回答 了 这 些 问 题 。 

探索 这 些 问 题 不 仅仅 具有 学 术 价值 。 除非 确 实 非常 小 , 否则 实际 中 的 应 用 程序 一 般 无 法 一 次 
性 全 部 模块 化 。 但 是 增 量 模块 化 同时 涉及 JAR 和 模块 、 类 路 径 和 模块 路 径 。 了 解 模 块 系统 的 类 
路 径 模式 工作 的 基本 原理 和 细节 非常 重要 。 


注意 ”围绕 无 名 模块 的 机 制 通常 在 编译 时 和 运行 时 均 适 用 ， 但 是 总 提 这 两 者 会 稍 显 哆 
唆 。 所 以 , 本 书 通常 只 描述 运行 时 的 行为 ， 并 且 仅 在 两 者 不 完全 相同 时 才 提 及 编译 时 的 
行为 。 

无 名 模块 包含 所 有 的 部 分 模块 化 类 ， 即 : 

D 在 编译 时 ， 正 在 被 编译 的 (不 包含 模块 描述 符 的 ) 类 ; 

口 在 编译 时 和 运行 时 ， 所 有 从 类 路 径 加 载 的 类 。 
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如 3.1.3 节 所 述 ， 所 有 模块 都 具有 3 个 主要 属性 ， 无 名 模块 也 是 如 此 。 
口 名 称 一 一 无 名 模块 没有 名 称 ，( 可 以 理解 吧 ? ) 这 意味 着 没有 其 他 模块 可 以 在 其 声明 中 提 
及 它 〈( 比 如， 依赖 它 )。 
口 依赖 一 一 无 名 模块 读 取 进 入 模块 图 的 所 有 其 他 模块 。 
口 导出 一 一 无 名 模块 导出 其 所 有 包 ， 并 且 开 放 它 们 以 支持 反射 (开放 式 包 和 开放 式 模块 的 
详细 信息 ,参见 12.2 前 。 

与 无 名 模块 相反 ， 所 有 的 其 他 模块 都 可 称 为 具名 模块 。META-INF/services 中 提供 的 服务 对 
于 ServiceLoader 来 说 均 可 用 。 服 务 的 相关 介绍 ， 参 见 第 10 章 ; 服务 与 无 名 模块 交互 的 相关 
介绍 ， 参 见 10.3.6 节 。 

尽管 不 是 很 直接 ,但 无 名 模块 的 概念 很 有 意义 。 在 这 里 ,你 可 以 看 到 有 序 的 模块 图 ， 从 男 一 
个 侧面 ， 你 可 以 看 到 类 路 径 上 的 混乱 状况 ， 这 些 JAR 带 着 自己 独特 的 属性 融入 到 了 模块 系统 中 
(如 图 8-2 所 示 )。( 为 了 不 使 事情 变 得 不 必要 地 复杂 ， 我 在 当时 没有 告诉 你 ， 无 名 模块 是 第 6 章 
和 第 7 章 的 基础 ， 现 在 你 可 以 把 每 处 的 类 路 径 上 的 内 容 用 无 名 模块 来 蔡 换 了 。 ) 

让 我 们 回 到 ServiceMonitor 应 用 程序 ， 并 假设 它 是 在 Java 9 之 前 编写 的 。 该 代码 及 其 组 织 结 
构 与 前 文 讨论 的 相同 ， 但 是 缺少 模块 声明 ， 因 此 你 将 创建 普通 JAR 而 非 模块 化 JAR。 

假设 jars 目录 包含 所 有 的 应 用 程序 JAR， 而 libs 目录 包含 所 有 的 依赖 ,那么 可 以 按 以 下 方式 
启动 应 用 程序 。 


$ java --class-path 'Jjars/x*':'1ibs/*' monitor.Main 


这 不 仅 适 用 于 Java 9 及 以 上 版 本 ， 而 且 除 了 --class-path 选项 的 替代 形式 ， 它 与 Java 8 
及 更 早 版 本 完全 一 致 。 图 8-2 展示 了 模块 系统 为 该 启动 配置 创建 的 模块 图 。 
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了 模块 图 无 名 模块 包括 类 
路 径 上 的 所 有 类 
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更 多 细节 参见 8.2.2 节 ) 
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无 名 模块 可 以 读 取 所 有 的 其 他 模块 
图 8-2 在 类 路 径 上 启动 所 有 应 用 程序 JAR 的 情况 下 , 模块 系统 从 平台 模块 ( 左 ) 构建 
模块 图 ， 并 将 类 路 径 上 的 所 有 类 分 配给 无 名 模块 ( 右 )， 后 者 可 以 读 取 所 有 其 
他 模块 
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有 了 这 种 理解 ,你 就 可 以 从 类 路 径 运 行 简单 的 部 分 模块 化 应 用 程序 了 。 除 了 基本 的 用 例 , 万 
其 是 在 缓慢 地 对 应 用 程序 进行 增 量 模块 化 时 , 无 名 模块 的 微妙 之 处 也 变 得 非常 重要 ,因此 我 们 接 
下 来 将 介绍 它们 。 


8.2.1 无 名 模块 捕获 的 类 路 径 混 乱 


无 名 模块 的 主要 目标 是 捕获 类 路 径 内 容 ， 并 使 其 在 模块 系统 中 工作 。 因 为 类 路 径 上 的 JAR 
之 间 从 来 没有 任何 界限 ,所 以 现在 建立 界限 是 没有 意义 的 。 因 此 对 于 整个 类 路 径 而 言 ， 只 生成 单 
一 的 无 名 模块 是 很 合理 的 决定 。 就 像 在 类 路 径 上 一 样 , 其 中 所 有 的 公有 类 都 是 可 访问 的 , 并且 包 
分 裂 的 概念 在 这 里 是 不 存在 的 。 

无 名 模块 的 独特 作用 及 其 对 向 后 兼容 性 的 关注 为 它 提 供 了 一 些 特 殊 的 属性 。 如 7.1 节 所 述 ， 
大 多 数 平台 模块 在 运行 时 为 无 名 模块 中 的 代码 禁用 了 强 封装 ( 至 少 在 Java 9、Java 10 和 Java 11 
中 。7.2 节 在 讨论 包 分 裂 时 曾 提 到 ， 无 名 模块 不 会 受到 扫描 ， 因 此 无 名 模块 与 其 他 模块 之 间 的 包 
分 裂 是 不 会 被 发 现 的 ， 并 且 类 路 径 上 的 那 部 分 是 不 可 用 的 。 

无 名 模块 的 组 成 这 一 细节 不 仅 有 点 违反 直觉 还 很 容易 出 错 。 这 似乎 显而易见 : 模块 化 JAR 
成 为 模块 而 普通 JAR 组 成 无 名 模块 。 这 正确 吗 ? 如 8.1.3 节 所 述 ， 这 是 错误 的 。 无 名 模块 负责 在 
类 路 径 上 的 所 有 JAR， 无 论 其 模块 化 与 否 ， 都 是 如 此 。 

因此 ， 模 块 化 JAR 并 不 一 定 要 作为 模块 加 载 ! 如 果 一 个 类 库 开 始 提供 模块 化 JAR， 它 的 用 
户 不 必 一 定 将 其 当 作 模块 使 用 。 用 户 可 以 将 它们 留 在 类 路 径 中 , 这 种 情况 下 它们 的 代码 将 被 捆绑 
进 无 名 模块 中 。 就 像 9.2 节 将 深入 解释 的 那样 ,这 使 生态 系统 得 以 在 不 对 其 他 JAR 的 模块 化 有 任 
何 依赖 的 情况 下 完成 对 某 一 个 JAR 的 模块 化 。 

举 个 例子 ， 启 动 完全 模块 化 版 本 的 ServiceMonitor， 并 日 一 次 从 类 路 径 启 动 ， 男 一 次 从 模块 
路 径 启 动 。 


$ java --class-path 'mods/*':'libs/*' -jar monitor 
$s java --module-path mods:libs --module monitor 


在 两 种 启动 方法 下 应 用 程序 都 可 以 正常 工作 ， 并 且 没 有 明显 的 差异 。 

有 一 种 方法 可 以 查看 模块 系统 如 何 处 理 这 两 种 场景 ， 就 是 使 用 12.3.3 节 将 详细 介绍 的 API。 
可 以 在 类 上 调用 getModqule， 获 取 其 所 属 的 模块 ， 然 后 在 该 模块 上 调用 getName ， 查 看 其 被 调 
用 的 内 容 。 针 对 无 名 模块 ，getName 返回 nul1l。 





























































































































使 Main 包含 以 下 代码 。 
String moduleName = Main.class.getModule() .getName (); 
System.out.println("Module name: " + moduleName); 


从 类 路 径 启动 时 ， 输 出 为 Module name: null， 这 表示 类 Main 最 终 存在 于 无 名 模块 中 。 
从 模块 路 径 启动 时 将 获得 Module name: monitor， 符合 预期 。 

5.2.3 节 曾 讨论 过 模块 系统 如 何 将 资源 封装 在 包 中 。 这 仅 部 分 适用 于 无 名 模块 : 模块 内 没有 
访问 限制 ( 因此 ， 类 路 径 上 的 所 有 JAR 都 可 以 访问 彼此 的 资源 )， 并 且 无 名 模块 将 所 有 包 开 放 以 
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支持 反射 (因此 ， 所 有 模块 都 可 以 访问 来 自 类 路 径 上 JAR 中 的 资源 )。 但 是 ， 强 封装 确实 适用 于 
从 无 名 模块 到 具名 模块 的 访问 。 


8.2.2 无 名 模块 的 模块 解析 


无 名 模块 与 其 余 模 块 图 关系 的 一 个 重要 方面 是 它 可 以 读 取 哪些 其 他 模块 。 如 前 文 所 述 , 它 可 
以 读 取 进入 模块 图 的 所 有 模块 。 但 是 具体 是 哪些 呢 ? 

请 记 住 ,在 3.4.1 节 中 ,模块 解析 是 从 根 模块 ( 尤其 是 初始 模块 ) 开始 ， 逐 一 添加 其 所 有 直 
接 依赖 和 传递 依赖 ， 进 而 完成 模块 图 构建 的 。 在 编译 代码 时 ， 或 应 用 程序 的 main 函数 在 无 名 模 
块 中 时 〈 即 从 类 路 径 上 启动 应 用 程序 )， 这 项 工作 将 如 何 进 行 ? 毕竟 ,普通 JAR 不 表达 任何 依赖 
关系 。 

如 果 初 始 模块 是 无 名 模块 , 那么 模块 解析 将 从 一 组 预定 义 的 根 模块 开始 。 根 据 经 验 ， 这 些 模 
块 是 系统 模块 (参见 3.1.4 节 )， 且 不 包含 JEE API， 但 是 实际 规则 更 为 详细 。 

口 java.* 模 块 集中 哪些 能 成 为 根 模块 取决 于 java.se 模块 是 否 可 见 ( 该 模块 呈现 整个 Java SE 
API 一 一 它 在 完整 的 Java 镜像 中 可 见 ， 但 在 由 jlink 创建 的 自 定义 运行 时 镜像 中 可 能 不 
是 这 样 )。 
四 如 果 java.se 可 见 ， 则 它 将 成 为 根 模 块 。 
田 如 果 java.se 不 可 见 , 那么 升级 模块 路 径 中 的 每 个 java.* 系 统 模 块 和 java.* 模 块 ， 只 要 至 
少 导出 一 个 不 限定 的 包 ( 意味 着 不 限制 谁 可 以 访问 该 包 ,， 参见 11.3 节 ), 就 可 以 成 为 根 
模块 。 
口 除了 java.* 模 块 之 外 ， 其 他 所 有 系统 模块 和 升级 模块 路 径 上 ( 除 孵 化 模块 外 ) 至 少 导出 一 
个 不 限定 包 的 模块 都 会 成 为 根 模块 。 这 与 jdk.* 和 javafx.* 模 块 尤 其 相关 。 
口 由 --adgd-modules 定义 的 模块 ( 参见 3.4.3 节 ) 始终 是 根 模块 。 

这 略微 有 点 复杂 (可视化 效果 如 图 8-3 所 示 )， 但 在 极端 情况 下 可 能 变 得 很 重要 。 根 据 经 验 ， 
解析 所 有 系统 模块 (JEE 和 孵化 模块 除外 ) 应 涵盖 至 少 90% 的 情况 。 
































































人 通过 add-modules 
java.se 十 | non-java.* 
系统 模块 和 升级 路 径 上 的 模块 (3) 
有 指定 前 级 或 (b) 至 少 导出 一 个 十 | 额外 的 根 模块 
不 限定 的 包 
G, 下 
java.* 十 | non-java.* 


图 8-3 ”哪些 模块 成 为 模块 解析 的 根 ( 参见 3.4.1 节 )， 取 决 于 是 否 使 用 --module 定义 
了 初始 模块 ( 如 果 未 定义 ， 那 么 无 名 模块 为 初始 模块 ) 以 及 java.se 是 否 可 见 。 
无 论 如 何 ， 用 --add-modules 定义 的 模块 始终 是 根 模块 
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例如 ， 你 可 以 运行 java --show-module-resolution 并 观察 输出 的 前 几 行 。 


root java.se jrt:/java.se 

root jdk.xml .dom jrt:/jdk.xml .dom 

root javafx.web jrt:/javafx.web 

root jdk.httpserver jrt:/jdk.httpserver 
root javafx.base jrt:/javafx.base 

t jdk.net jrt:/jdk.net 

root javafx.controls jrt:/javafx.controls 
root jdk.compiler jrt:/jdk.compiler 

root oracle.desktop jrt:/oracle.desktop 
root jdk.unsupportedqd jrt:/jdk.unsupported 


这 不 是 全 部 输出 ,并且 在 不 同系 统 上 其 顺序 可 能 不 同 。 但 是 从 它 的 顶部 开始 ,可 以 看 到 java.se 
是 唯一 的 java.* 模 块 。 然 后 是 一 系列 jdk.* 模 块 和 javafx.* 模 块 (jdk.unsupported 参考 7.1.1 区 ， 
以 及 一 个 oracle.* 模 块 ( 可 以 忽略 )。 


要 点 ”请 注意 ,在 以 无 名 模块 为 初始 模块 的 情况 下 ， 根 模块 集 始终 是 运行 时 镜像 
中 包含 的 系统 模块 的 子 集 。 除 非 使 用 --add-modules 显 式 添加 ， 否 则 模块 路 径 
上 存在 的 模块 将 永远 无 法 解析 。 如 果 对 模块 路 径 进 行 了 手动 处 理 , 以 完全 和 包含 所 需 
的 模块 ， 那 么 如 3.4.3 节 中 所 述 ， 你 可 能 需要 使 用 --add-modules ALL-MODULE- 
PATH 添加 所 有 模块 。 


可 以 通过 从 模块 路 径 启 动 ServiceMonitor 而 不 定义 初始 模块 来 轻松 观察 该 行为 。 


$ java --module-path mods:libs monitor .Main 
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> Error: Could not find or load main class monitor.Main 
> Caused by: java.lang.ClassNotFoundException: monitor.Main 


使 用 --show-module-resolution 运行 相同 的 命令 ， 可 以 证 实 没有 monitor.* 模 块 遭 到 解析 。 
要 解决 此 问题 可 以 使 用 --add-modules monitor， 这 样 monitor 模块 将 被 加 到 根 模块 列表 中 ; 或 
者 使 用 --module monitor/monitor.Main， 这 样 monitor 模块 将 成 为 唯一 的 根 模块 (初始 模块 )。 


8.2.3 ”取决 于 无 名 模块 


模块 系统 的 主要 目标 之 一 是 实现 可 靠 配 置 : 模块 必须 表达 其 依赖 , 并 且 模 块 系统 必须 能 够 保 
证 它们 存在 。3.2 节 曾 讨论 过 带 有 模块 描述 符 的 可 见 模 块 的 问题 。 如 果 尝 试 将 可 靠 配置 扩展 到 类 
路 径 ， 会 发 生 什么 ? 

先 来 进行 一 个 思想 实验 。 假 设 模 块 依赖 于 类 路 径 上 的 内 容 ， 比 如 其 描述 符 中 使 用 了 类 似 
requires class-path 的 内 容 。 那 么 模块 系统 可 以 为 这 种 依赖 提供 什么 保证 呢 ? 事实 证 明 ， 几 
乎 没有 。 只 要 类 路 径 上 至 少 有 一 个 类 , 模块 系统 就 必须 假定 已 满足 其 所 有 依赖 关系 ,所 以 这 是 无 
济 于 事 的 ( 如 图 8-4 所 示 )。 

更 糟糕 的 是 , 这 将 严重 破坏 配置 的 可 靠 性 , 因为 最 终 你 的 模块 可 能 需要 requires class-patho 
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好 吧 ， 它 几乎 不 包含 任何 信息 : 类 路 径 究竟 需要 什么 (再 看 一 下 图 8-4 ) ? 


requires 
com.framework 





何 时 满足 ?JPMS 
不 知道 











com.framework com.framework 


| 
| 


你 需要 在 类 路 径 上 


[a 


requires requires 
class-path | class-path 


类 路 径 内 容 类 路 径 内 容 


知道 


222 ?323 





图 8-4 如果 com.framework (通过 requires class-path 语句 ) 依赖 于 一 些 类 路 径 
上 的 内 容 ， 那 么 模块 系统 无 法 判断 依赖 是 否 得 到 满足 ( 左 )。 如 果 你 在 该 框架 
上 构建 应 用 程序 ， 你 将 不 知道 如 何 满足 这 种 依赖 关系 ( 右 ) 








让 这 个 假设 更 进一步 。 设 想 ， 模 块 com.framework 和 org.library 依赖 于 相同 的 第 三 方 模块 ， 
比如 SLF4J。 一 个 依赖 于 模块 化 之 前 的 SLF4J， 因 此 需要 redquires class-path; 另 一 个 依赖 
于 模块 化 的 SLF4J， 因 此 需要 requires org.slf4j( 假设 这 是 模块 名 )。 同 时 依赖 于 com.framework 
和 org.library 的 人 , 会 如 何 放置 SLF4J 的 JAR 呢 ? 无 论 选 择 哪 一 种 , 模块 系统 必然 无 法 满足 其 中 








一 个 传递 依赖 ， 图 8-5 显示 了 这 种 假设 的 情况 。 
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requires 


org.slf4j 


class-path org.slf4j class-path 











类 路 径 内 容 


1 





fio 


如 果 SLF4J 被 放置 在 类 路 径 上 ， 
那么 org.library 对 org.slf4j 的 依 
赖 未 被 满足 


如 果 SLEF4J 被 放置 在 模块 路 径 上 ， 

那么 com.framework 将 无 法 在 类 

路 径 上 找到 它 

图 8-5 假设 com.framework 依赖 于 SLF4J ( requires class-path )，org.library 依赖 于 SLF4J 
模块 ( requires org.s1lf4j ), 没有 办 法 同时 满足 这 两 项 要 求 。 无 论 SLF4J 是 放 在 类 路 
径 上 ( 左 ) 还 是 模块 路 径 上 ( 右 )， 这 两 个 依赖 中 有 一 个 被 认为 是 无 法 满足 的 
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妇 
patho 
在 模块 系统 中 , 模块 使 用 名 称 引 用 其 他 模块 。 那么 ,如何 更 好 地 表示 最 终 包含 类 路 径 内 容 的 
模块 不 能 被 依赖 ?不 给 这 个 模块 命名 一 一 也 就 是 说 无 名 一 一 听 起 来 很 合理 。 
于 是 , 得 到 一 个 没有 名 称 的 无 名 模块 , 因为 没有 模块 能 用 requires 指令 或 任何 其 他 指令 引 
用 它 。 没 有 requires 就 没有 可 读 性 边 ; 没有 可 读 性 边 ， 模 块 就 无 法 访问 无 名 模块 中 的 代码 。 
总 之 ， 清 晰 模块 要 依赖 某 个 工件 ， 该 工件 必须 位 于 模块 路 径 上 。 正 如 8.1.3 节 中 提 到 的 ， 这 
可 能 意味 着 将 普通 JAR 放 在 模块 路 径 上 ， 把 它们 转换 为 自动 模块 。 接 下 来 将 探讨 这 个 概念 。 


8.3 自动 模块 : 模块 路 径 上 的 普通 JAR 


任何 模块 化 工作 的 长 期 目标 都 是 将 普通 JAR 升级 为 模块 化 JAR， 并 将 它们 从 类 路 径 移 动 到 
模块 路 径 。 一 种 方法 是 , 等 到 所 有 依赖 都 以 模块 的 形式 出 现 后 再 模块 化 自己 的 项 目 一 一 这 是 一 种 
自 下 而 上 的 方法 。 不 过 ， 这 可 能 需要 很 长 时 间 ， 因 此 模块 系统 也 允许 自 上 而 下 的 模块 化 方法 。 

9.2 节 将 详细 解释 这 两 种 方法 ,但 是 要 采用 自 上 而 下 的 方法 ， 首 先 需 要 一 种 新 的 技术 手段 。 
考虑 一 下 : 如 果 依 赖 以 普通 JAR 的 形式 出 现 ， 你 将 如 何 声明 模块 ? 正如 8.2.3 节 所 述 ， 如 果 将 它 
们 放 在 类 路 径 上 ， 它 们 最 终 会 出 现在 无 名 模块 中 ， 而 你 的 模块 无 法 访问 该 模块 。 但 是 ，8.1.3 节 
曾 提 到 过 ， 普 通 JAR 也 可 以 放 在 模块 路 径 上 ， 模 块 系统 将 自动 为 它们 创建 模块 。 


注意 围绕 自动 模块 的 机 制 通常 适用 于 编译 时 和 运行 时 。 前 文 曾 说 过 ， 如 果 总 是 提 到 这 
两 个 词 的 话 ， 不 仅 增加 的 信息 量 很 少 ， 而 且 会 使 文章 更 难 阅读 。 


针对 模块 路 径 上 每 个 没有 模块 描述 符 的 JAR, 模块 系统 都 将 创建 一 个 自动 模块 。 它 与 任何 其 

他 具名 模块 一 样 ， 有 3 个 核心 属性 (参见 3.1.3 前 。 

口 名 称 可 以 在 JAR 的 manifest 文件 中 使 用 Automatic-Module-Name 头 来 确定 自动 模 

块 的 名 称 。 如 果 未 填写 ， 模 块 系统 将 基于 文件 名 生成 一 个 名 称 。 

口 依赖 一 一 自动 模块 可 以 读 取 其 他 所 有 进入 模块 图 的 模块 ， 包 括 无 名 模块 你 很 快 就 会 看 

到 ， 这 一 点 很 重要 )。 

口 导出 一 一 自动 模块 导出 它 的 所 有 包 并 开放 它们 以 方便 反射 (开放 式 包 和 模块 的 详细 信息 ， 
参见 12.2 前 。 

此 外 ， 可 执行 JAR 会 生成 可 执行 模块 ， 这 些 模块 的 主 类 将 被 标记 ( 参见 4.5.3 节 )。 
META-INF/services 中 提供 的 服务 对 serviceLoaaet 而 言 是 可 用 的 。 对 服务 的 介绍 , 参见 第 
10 章 。 请 特别 关注 10.3.6 节 ， 了 人 解 它们 与 自动 模块 的 交互 。 

再 次 假设 ServiceMonitor 还 没有 模块 化 ,但 此 时 你 仍然 可 以 将 其 工件 放 在 模块 路 径 上 。 如 果 
目录 jar-mp 包含 monitor.jar、monitor.observer.jar 和 monitor.statistics.jar, 而 


目录 jars-cp 包含 所 有 其 他 应 用 程序 和 依赖 JAR， 你 可 以 用 如 下 命令 启动 ServiceMonitor。 


JT 


果 想 要 可 靠 的 模块 ,那么 依赖 哪个 类 路 径 的 内 容 都 不 是 好 主意 , 因此 无 须 requires class- 
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$ java 
--module-path jars-mp 
--Class-path 'jars-cp/*' 
--module monitor/monitor.Main 


可 以 在 图 8-6 中 看 到 最 终 的 模块 图 。 有 些 细节 可 能 还 不 清楚 ，( 比如 ， 为 什么 在 命令 行 只 引 
用 monitor 的 情况 下 ， 所 有 3 个 自动 模块 都 出 现在 图 中 ? ) 别 担心 ， 下 一 节 将 进行 解释 。 


模块 路 径 上 的 普通 JAR 被 转换 类 路 径 上 的 JAR 文 件 被 转换 为 
为 自动 模块 无 名 模块 































monitor 
automatic 









monitor.observer monitor. statistics 
automatic automatic 














3 动 模块 和 无 名 模块 读 取 所 有 其 他 模块 ， 
Ff 以 这 个 图 有 很 多 边 








图 8-6 把 monitor.jar、monitor.observer.jar 和 monitor. statistics.jar 
这 几 个 普通 JAR 放 在 模块 路 径 上 ，JPMS 为 它们 创建 了 3 个 自动 模块 。 类 路 径 
上 的 内 容 像 以 前 一 样 被 视 为 无 名 模块 。 请 注意 自动 模块 如 何 相互 读 取 ， 以 及 它 
们 如 何 读 取 无 名 模块 ， 并 且 在 图 中 创建 许多 循环 
自动 模块 是 功能 完备 的 具名 模块 ， 这 意味 着 : 
口 可 以 在 其 他 模块 的 声明 中 通过 名 称 引用 它们 ， 例 如 通过 requires 指令 ; 
口 强 封装 使 它们 不 能 使 用 平台 模块 的 内 部 功能 〈 与 无 名 模块 不 同 ); 
口 它们 接受 包 分 裂 检查 。 
男 一 方面 ， 它 们 确实 有 一 些 独特 之 处 。9.2 节 将 开始 使 用 自动 模块 ， 在 此 之 前 本 章 先 讨论 一 
下 电 s 


8.3.1 自动 模块 名 称 : 小 细节 ， 大 影响 


将 普通 JAR 转换 为 模块 的 主要 目的 是 在 模块 声明 中 依赖 它们 。 为 此 ， 它 们 需要 一 个 名 称 ， 
但 是 缺少 模块 描述 符 ， 名 称 从 何 而 来 ? 


1. 首先 是 manifest 条 目 ， 然 后 是 文件 名 
确定 普通 JAR 模块 名 称 的 一 种 方法 是 基于 其 manifest 文 件 ， 即 JAR 中 META-INF 目录 下 的 
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MANIFEST.MEF 文件 。manifest 文件 包含 头 值 对 ( header-value pairs ) 形式 的 各 种 信息 ， 其 中 最 重 
要 一 个 头 是 Main-class, 它 通 过 命名 包含 main 哺 数 的 类 定义 了 一 个 部 分 模块 化 应 用 程序 的 入 
口 点 。 这 使 得 通过 java -jar app.jar 来 启动 应 用 程序 成 为 可 能 。 

如 果 模 块 路 径 上 的 JAR 文件 不 包含 模块 描述 符 ， 模 块 系统 将 通过 以 下 两 步 确 定 自动 模块 的 
名 称 。 

(1) 在 manifest 文件 中 查找 Automatic-Module-Name 头 ， 如 果 找 到 它 ， 就 使 用 对 应 的 值 作 
为 模块 的 名 称 。 

(2) 如 果 没 有 在 manifest 文件 中 找到 对 应 涉 ， 那 么 模块 系统 将 根据 文件 名 推断 模块 名 称 。 

从 manifest 文件 中 推断 模块 的 名 称 是 一 种 值得 推荐 的 方式 ， 因 为 这 样 比较 稳定 ,详细 信息 参 
见 8.3.4 节 。 

从 文件 名 推断 模块 名 称 的 具体 规则 有 点 复杂 ， 但 细节 并 不 太 重 要 。 要 点 如 下 : 

口 JAR 文件 名 通常 以 版 本 字符 串 结尾 ( 比如 -2.0.5 )， 版 本 是 可 以 识别 和 忽略 的 ; 
口 除 字 母 和 数字 外 ， 每 个 字符 都 被 转换 成 一 个 点 。 

这 个 过 程 可 能 导致 不 好 的 结果 ， 令 产生 的 模块 名 称 无 效 。 字 节 码 操作 工具 Byte Buddy 就 是 
一 个 例子 : 它 在 Maven Central 中 的 名 称 为 pyte-pbuddy-${version} .jar, 这 导致 自动 模块 名 
为 byte.buddy。 很 遗憾 ， 这 是 非法 的 ， 因 为 pyte 是 一 个 Java 关键 字 ( 9.3.3 节 提 出 了 关于 解决 
这 些 问 题 的 建议 )。 

为 了 避免 对 模块 系统 为 给 定 的 JAR 选择 了 哪个 名 称 进行 猜测 ， 你 可 以 使 用 jar 工具 查看 。 


S jar --describe-module --file=${jarfile} 


如 果 JAR 缺少 模块 描述 符 ， 前 部 分 输出 如 下 。 































































































No module descriptor found. Derived automatic module. 


$s{module-name}@s {module-version} automatic 


> 
2 
a 
> requires java.base mandated 





$s {mogdule-name} 是 实际 名 称 的 占 位 符 ， 你 需要 查找 实际 名 称 。 很 遗憾 ， 这 并 不 能 告诉 你 名 
称 是 从 manifest 条 目 还 是 文件 名 中 获取 的 。 要 找到 答案 ， 有 如 下 几 个 选择 : 
口 使 用 命令 jar --file ${jarfile}) --extract META-INF/MANIFEST.MF 获取 manifest 
文件 ， 然 后 手动 查看 ; 
口 在 Linux 系统 上 ， 命 令 unzip -p S${jarfile} META-INF/MANIFEST.MF 打印 manifest 
文件 内 容 到 控制 台 ， 然 后 保存 在 文件 中 ; 
口 重 命名 文件 ， 然 后 再 次 运行 jar --describe-module。 
这 里 以 Guava 20.0 为 例 。 





























$ jar --describe-module --file guava-20.0.jar 


> No module descriptor found. Derived automatic module. 
> 
> guava@20.0 automatic 
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> requires java.base mandated 

# 省 略 了 一 些 包 

作为 一 个 自动 模块 ，Guava 20.0 被 称 为 guava。 这 是 通用 的 还 是 基于 模块 名 的 ? 通过 unzip 
工具 ， 查 看 manifest 文件 的 内 容 。 


Manifest-Version: 1.0 

Build-Jdk: 1.7.0-google-v5 

Built-By: cgdecker 

Created-By: Apache Maven Bundle Plugin 
[…… 省 略 了 与 OSGi 相关 的 条 目 .……] 


可 以 看 到 ，Automatic-Module-Name 没有 经 过 设置 。 将 文件 重 命名 为 com.google.guava- 
20.0.jar， 生 成 模块 名 称 com.google.guava。 
如 果 使 用 一 个 不 太 过 时 的 版 本 ， 比 如 Guava-23.6， 会 得 到 如 下 输出 。 


$ jar --describe-module --file guava-23.6-jre.jar 





















































> No module descriptor found. Derived automatic module. 
> 

> com.google.common@23.6-jre automatic 

> requires java.base mandated 

# 省 略 了 一 些 包 


从 所 选 名 称 和 文件 名 不 相同 的 事实 可 以 看 出 ，Google 选择 com.google.common 作为 Guava 
的 模块 名 称 。 用 unzip 来 查看 一 下 。 
Manifest-Version: 1.0 


Automatic-Module-Name: com.google.common 
Build-Jdk: 1.8.0_112-google-v7 





好 了 ，Automatic-Module-Name 得 到 了 设置 。 


2. 何 时 设置 Automatic-Module-Name 
如 果 你 正在 维护 一 个 公开 发 布 的 项 目 ， 这 就 意味 着 它 的 工件 可 以 通过 Maven Central 或 其 他 

公共 仓库 获得 , 那么 你 应 该 仔细 考虑 何 时 在 manifest 文件 中 设置 Automatic-Module-Name。 正 

如 8.3.4 节 将 解释 的 那样 ， 这 可 以 让 作为 自动 化 模块 使 用 的 项 目 更 加 可 靠 ， 但 同时 也 带 来 了 一 个 

承诺 ， 那 就 是 将 来 要 以 清晰 模块 代替 当前 的 JAR。 你 实际 上 是 在 说 :“ 模 块 就 是 这 样 ， 只 是 还 没 

来 得 及 发 布 。” 

定义 一 个 自动 模块 名 称 会 让 用 户 开 始 把 你 的 工件 视 作 模块 。 这 一 事实 有 几 个 重要 的 含义 。 

口 未 来 模块 的 名 称 必须 与 现在 声明 的 名 称 完 全 相同 ( 和 否则， 由 于 缺少 模块 ， 不 可 靠 配置 会 

影响 你 的 用 户 )。 

口 工件 结构 必须 保持 不 变 ， 因 此 不 能 将 受 支 持 的 类 或 包 从 一 个 JAR 移动 到 另 一 个 JAR ( 即 
使 没有 模块 系统 ， 本 书 也 不 建议 这 样 做 。 对 于 类 路 径 而 言 ， 哪 个 JAR 包含 某 个 类 并 不 重 
要 ， 因 为 这 不 会 影响 对 它 的 使 用 。 然 而 在 使 用 模块 系统 时 ， 类 的 所 属 模块 很 重要 ， 因 为 
可 访问 性 要 求 用 户 找到 正确 的 模块 )。 
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口 该 项 目 在 Java 9 及 以 上 版 本 中 运行 得 相当 好 。 如 果 它 需要 命令 行 选 项 或 其 他 变通 方式 ， 
这 些 都 已 经 被 很 好 地 文档 化 了 否则， 你 不 能 确定 代码 中 是 否 隐 藏 了 其 他 问题 ， 而 这 些 
问题 可 能 导致 承诺 失去 意义 )。 
当然 ， 软 件 开 发 “有 时 是 不 可 预测 的 "， 所 以 这 些 都 不 能 保证 万 无 一 失 。 但 是 你 应 该 相信 自 
己 可 以 坚持 这 些 承诺 。 如 果 没 有 足够 的 精力 在 Java9 及 以 上 版 本 中 进行 测试 , 或 者 发 现 将 导致 模 
块 化 结果 不 可 预测 的 问题 ， 那 么 请 诚实 地 面 对 这 种 情况 ,暂且 不 要 设置 Automatic-Module- 
Name。 如 果 你 设置 了 它 ， 并 且 无 论 如 何 都 必须 进行 这 样 的 更 改 ， 那 么 进行 一 次 主要 版 本 升级 就 
可 以 了 。 图 8-7 展示 了 设置 Automatic-Module-Name 的 示例 。 
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设置 Automatic-Module-Name ee 因此 ， 当 JAR 被 模块 化 后 ， 

之 前 ， 在 JAR 之 间 重 新 排列 包 ……… 包 就 不 能 移动 了 
图 8-7 ”如 果 你 计划 在 模块 化 项 目 之 前 , 在 包 之 间 移 动 类 或 在 JAR 之 间 移 动 包 , 请 暂缓 设 
置 Automatic-Module-Name， 直 到 该 工作 完成 。 在 这 里 , 项 目的 JAR ( 左 ) 在 
使 用 自动 模块 名 发 布 之 前 进行 了 重 构 ( 中 )， 因 此 当 它 们 进行 模块 化 ( 右 ) 时 ， 
结构 不 会 再 发 生 改 变 


要 设置 Automatic-Module-Name， 你 的 项 目 不 需 要 针对 Java 9 及 以 上 版 本 。JAR 中 可 能 
包含 为 JVM 老 版 本 编译 的 字 节 码 ， 但 是 定义 模块 名 称 对 于 模块 系统 的 用 户 仍然 有 帮助 ， 模 块 描 
述 符 也 是 如 此 ， 正 如 9.3.4 节 所 讲 的 那样 。 


8.3.2 自动 模块 的 模块 解析 


理解 模块 系统 如 何在 模块 解析 期 间 构建 模块 图 是 理解 和 预测 模块 系统 行为 的 一 个 关键 因素 。 
对 于 显 式 模块 而 言 ， 这 很 简单 (requires 指令 ,参见 3.4.1 节 ) 但 是 对 于 无 名 模块 ， 它 更 加 复 
杂 (参见 7.2.2 节 )， 因 为 普通 JAR 不 能 表达 依赖 关系 。 

自动 模块 也 是 由 普通 JAR 创建 的 ， 因 此 它们 也 没有 显 式 的 依赖 关系 ， 这 就 引出 了 一 个 问题 ; 
它们 在 解析 期 间 的 行为 是 什么 样 的 。 后 文 将 马上 回答 这 个 问题 , 但 是 正如 后 文 所 述 ， 这 将 导致 一 
个 新 的 问题 : 你 应 该 将 自动 模块 的 依赖 放 在 哪里 ， 类 路 径 或 模块 路 径 上 吗 ? 阅读 完 本 节 ， 你 就 会 
知道 答案 。 


1. 解析 自动 模块 的 依赖 
第 一 个 要 回答 的 问题 是 ， 在 模块 解析 期 间 ， 如 果 JPMS 遇 到 一 个 自动 模块 会 发 生 什 么 。 自 动 
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模块 是 为 了 解决 部 分 模块 化 依赖 的 模块 化 问题 而 创建 的 , 因此 在 开发 人 员 积 极 把 项 目 模 块 化 的 情 
况 下 ， 可 以 使 用 它们 。 在 这 种 情况 下， 如 果 每 个 平台 模块 都 引入 自动 模块 ( 就 像 无 名 模块 那样 ) 
将 很 糟糕 ， 所 以 一 般 人 们 不 会 这 样 做 〈 需 要 说 明 的 是 ， 他 们 也 不 显 式 引 入 任何 应 用 程序 模块 )。 

尽管 如 此 ， 但 通常 JAR 会 互相 依赖 ;如 果 模 块 系统 只 解析 了 显 式 依赖 的 自动 模块 ， 那 么 所 
有 其 他 的 自动 模块 都 必须 用 --add-modules 添加 到 图 中 。 对 于 有 数 百 个 依赖 的 大 型 项 目 而 言 ， 
将 这 些 依赖 项 放 在 模块 路 径 上 的 情形 是 难以 想象 的 。 为 了 防止 手动 添加 模块 这 种 繁重 而 琐碎 的 操 
作 ，JPMS 一 旦 遇 到 第 一 个 自动 模块 ， 就 会 引入 所 有 的 自动 模块 。 

一 旦 解析 了 一 个 自动 模块 ， 所 有 其 他 模块 也 都 被 解析 。 你 可 以 将 所 有 普通 JAR 添加 为 自动 
模块 ( 至 少 依赖 或 添加 一 个 )， 也 可 以 一 个 也 不 添加 ( 相反 )。 这 解释 了 为 什么 图 8-6 中 虽然 只 添 
加 了 不 能 表达 依赖 关系 的 monitor 模块 ， 却 因为 将 其 设置 为 根 模块 而 有 3 个 monitor.* 模 块 。 

请 注意 ， 自 动 模块 对 其 他 自动 模块 而 言 是 可 读 的 (参见 9.1 节 )， 这 意味 着 任何 模块 只 要 能 
读 取 一 个 ， 就 能 读 取 全 部 。 在 确定 自动 模块 的 依赖 关系 时 ,请 记 住 这 一 点 一 一 反复 试 错 可 以 减少 
所 需 的 requires 指令 。 

在 ServiceMonitor 应 用 程序 中 ，monitorrest 模块 依赖 Spark Web 框架 ， 在 本 例 中 它 也 依赖 于 
Guava。 这 两 个 依赖 都 是 普通 的 JAR， 所 以 monitor.rest 需要 将 它们 作为 自动 模块 。 

module monitor.rest { 

requires spark.core; 


requires com.google.common; 
requires monitor.statistics; 






























































exports monitor.rest; 


} 

















问题 是 ， 尽 管 spark.core 或 com.google.common 中 可 能 缺少 一 个 requires 指令 ， 一切 却 可 
以 正常 运行 。 当 模块 系统 解析 第 一 个 自动 模块 时 , 将 解析 其 他 所 有 自动 模块 ; 任何 模块 只 要 读 取 
了 其 中 一 个 ， 都 可 以 读 取 其 他 所 有 自动 模块 。 

因此 ， 即使 没有 requires com.google.common 指令 ， guava.jar 也 会 与 spark.core.jar 
一 起 作为 自动 模块 出 现 ， 因 为 monitorrest 能 读 取 spark.core， 所 以 它 也 能 读 取 guava。 请 确保 依 
赖 关系 正确 ( 比如 使 用 JDeps， 参 见 附录 D )。 











模块 图 中 的 循环 

“自动 模块 读 取 其 他 所 有 模块 ”中 隐藏 了 一 个 重要 细节 : 这 种 方法 会 在 模块 图 中 创建 循环 。 
显然 ,至少 有 一 个 模块 依赖 于 自动 模块 , ( 否则 它 为 何 会 出 现在 模块 图 中 呢 ? ) 并 且 读 取 它 ; 
同样 ， 自 动 模块 也 读 取 该 模块 。 

虽然 这 不 会 造成 实质 上 的 不 良 后 果 , 但 此 处 需要 澄清 , 这 并 不 违背 禁止 静态 依赖 循环 的 规 
则 (参见 3.2.1 节 ), 因为 由 自动 模块 引起 的 循环 不 是 静态 声明 导致 的 ,而 是 由 模块 系统 动态 引 
入 的 。 
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如 果 自 动 模块 只 能 读 取 其 他 具名 模块 ， 


那么 任务 就 完成 了 。 一 且 将 普通 JAR 放 在 模块 路 径 
上 , 那么 它 的 所 有 直接 依赖 也 必须 放 到 模块 路 径 上 ,然后 这 些 直 接 依赖 的 依赖 也 是 如 此 ， 以 此 类 








推 ， 直 到 所 有 传递 依赖 都 被 视 为 模块 ( 显 式 的 或 自动 的 )。 











不 过 ,将 所 有 普通 














赖 关系 可 以 在 类 路 径 上 或 模块 路 径 上 。 
2. 选择 传递 依赖 的 路 径 














对 于 自动 模块 的 依赖 ， 通 常 有 两 个 选项 〈 请 记 住 ， 也 可 以 使 用 JDeps 列 出 它们 )， 类 路 径 或 
模块 路 径 。 遗 憾 的 是 ， 并非 在 所 有 环境 下 都 可 以 自由 选择 ,在 某 些 情 况 下 ,你 需要 做 的 不 仅仅 是 





决定 采用 哪 种 方式 。 





根据 其 他 模块 是 否 依赖 这 些 模 块 ， 以 及 它们 是 平台 模块 、 普 通 JAR 还 是 模块 JAR， 表 8-2 


JAR 转换 成 自动 模块 也 有 缺点 《更 多 信息 参见 8.3.3 节 )， 所 以 最 好 将 它 
们 放 在 类 路 径 上 ， 并 加 载 为 无 名 模块 。 模 块 系统 允许 自动 模块 读 取 无 名 模块 ,这 意味 着 它们 的 依 








列 出 了 将 这 些 依赖 引入 模块 图 的 选项 。 如 下 几 幅 图 反映 了 具体 情况 。 
口 图 8-8 展示 了 在 默认 情况 下 ， 仅 被 自动 模块 所 依赖 的 平台 模块 是 不 会 得 到 解析 的 。 


your.app 依 赖 于 java.xml ， 很 老 运 
所 以 它 出 现在 模块 图 中 








的 平台 模块 可 能 












































org.jooq 需 要 java.xml 
地 运 ， 它 被 展示 在 模块 


图 中 





org.joodq 也 需要 java.sql， 但 是 





它 无 法 表达 这 个 依赖 ， 而 同时 
没有 甚 他 模块 需要 SQL ， 所 以 
模块 图 中 缺少 后 者 





图 8-8 ”如 果 一 个 项 目 (本 例 中 是 your .app ) 使 用 了 自动 化 模块 (org.jooq )， 你 将 无 
法 确定 模块 图 是 否 与 期 望 一 致 
会 出 现在 模块 图 中 (本 例 中 这 发 生 在 了 java.sql 上 )， 而 是 需 





因为 自动 模块 不 能 表达 依赖 ， 所 以 它们 所 需要 








要 通过 --add-modules 来 添加 


口 图 8-9 涵盖 了 自动 模块 所 需要 的 普通 JAR 的 几 种 不 同情 况 。 
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monitor 模 块 依 
赖 于 slf4jjar 


决定 将 这 个 放 入 模块 这 个 应 该 放 在 哪儿 ? 


路 径 中 






monitor 模 块 不 
依赖 于 slf4j jar 


JAR 依 赖 slf4j .jar 在 类 路 径 中 





slf4j .jar 在 模块 路 径 中 


[要 slf 
要 slf4j， 
但 是 ; 读 名 
这 个 依赖 造成 了 模块 
所 有 区 别 
fT 有 区 别 人 由 monitor 引 入 
J unnamed 
Ew WF 
必 > 
monitor.rest SI 
. 内 automatic 


spark.core 


automatic 





























monitor 


上 
上 也 模块 由 “全 有 全 无 ” 
unnamed (name | 式 自 动 模块 解析 
引入 






monitor.rest olla] pd 
多 - 4 
~ < 





区 1@ wo 的 

图 8-9 ”从 monitorrest ( 模块 化 JAR ) 对 spark.core (普通 JAR ) 的 依赖 开始 ， 后 者 需 
要 被 放置 在 模块 路 径 中 。 但 是 它 的 依赖 sj ( 另 一 个 普通 JAR ) 呢 此 处 可 以 
看 到 ， 由 此 产生 的 模块 图 依赖 于 slfj 是 否 被 另 一 个 模块 化 JAR 所 依赖 (上 下 
两 行 对 比 )， 或 者 它 被 放置 在 哪个 路 径 中 ( 中 间 一 列 与 右边 一 列 对 比 ) 看 上 去 
模块 路 径 占 了 绝对 优势 ， 但 是 再 看 一 下 图 8-10 












































口 图 8-10 展示 了 当 一 个 传递 依赖 由 普通 JAR 转换 为 模块 化 JAR 时 模块 图 的 演进 。 


slf4j 被 











JAR 依 天 sltj 是 一 个 普通 JARA 一 访 央 化 Saltj 是 一 个 模块 化 JAR 
不 被 任何 其 他 自动 
| ee 模块 依赖 或 引入 ， 
性 ~、 2» 所 以 不 被 解析 
~ Ga) J 
Ge 
dQdQ-moQuUules 


























决定 将 这 些 放 入 模块 路 径 中 “全 有 全 无 " 式 上 添加 sl 

动 模块 解析 引入 

图 8-10 在 与 图 8-9 右 下 角 相 同 的 场景 下 , 如果 放置 在 模块 路 径 中 的 某 个 自动 模块 的 传 
递 依赖 ( slf4j ) 被 模块 化 后 , 会 发 生 什么 ” 它 将 不 再 被 默认 解析 ， 而 是 需要 通 
过 --add-modules 手动 添加 以 解析 


表 8-2 ”如 何 将 自动 模块 的 依赖 添加 到 模块 图 中 
另 一 个 清晰 模块 所 需要 的 依赖 


















































类 路 径 模块 路 径 
平台 模块 v 
普通 JAR X (依赖 未 满足 ) v 
模块 化 JAR X (依赖 未 满足 ) v 
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( 续 ) 
清晰 模块 不 需要 的 依赖 
类 路 径 模块 路 径 
平台 模块 ! (手动 解析 ) 
普通 JAR v w (自动 化 解析 ) 
模块 化 JAR v ! (手动 解析 ) 











仔细 观察 平台 模块 后 , 我们 发 现 自动 模块 无 法 表达 对 它们 的 依赖 。 结 果 是 , 模块 图 不 一 定 会 
包含 它们 。 如 果 没 有 包含 它们 ， 那 么 自动 模块 在 运行 时 很 可 能 会 由 于 缺少 相关 类 而 失败 。 

这 个 问题 唯一 的 解决 方法 是 , 项 目的 维护 者 将 所 需要 的 模块 发 布 到 公开 文档 中 , 这 样 用 户 就 
可 以 确保 所 需要 的 模块 存在 。 用 户 既 可 以 明确 声明 依赖 ( 比如, 在 依赖 于 自动 模块 的 模块 当中 声 
明 )， 也 可 以 使 用 --add-modules 选项 来 达到 这 个 目的 。 

在 检查 完 对 平台 模块 的 依赖 后 , 来 看 一 下 应 用 程序 模块 。 如 果 某 个 自动 模块 的 依赖 被 清晰 模 
块 所 需要 , 那么 它们 需要 被 放置 到 模块 路 径 中 ， 以 方便 模块 系统 对 其 解析 ， 而 且 不 需要 任何 其 他 
步骤 。 如 果 没 有 清晰 模块 需要 它们 ,那么 JAR 既 可 以 被 放置 在 类 路 径 中 (它们 会 被 转化 为 无 名 
模块 ， 因 此 一 直 可 被 访问 )， 也 可 以 被 放置 在 模块 路 径 中 ( 它们 会 被 其 他 的 机 制 放 入 模块 图 中 )。 
口 普通 JAR 由 自动 模块 解析 按照 “全 有 全 无 ”的 方式 引入 。 
口 平台 模块 和 清晰 应 用 程序 模块 在 默认 情况 下 不 会 得 到 解析 ， 需 要 利用 其 他 模块 对 它们 进 
行 依赖 或 是 通过 --add-modules 进行 手动 添加 (参见 3.4.3 欧 。 

考虑 到 多 数 甚至 所 有 依赖 在 某 个 时 间 将 从 普通 JAR 转换 成 模块 化 JAR， 这 两 种 现象 非常 引 
人 注意 : 它们 暗示 着 模块 路 径 中 的 传递 依赖 在 作为 普通 JAR 时 工作 正常 ;一旦 被 模块 化 ， 它 们 
就 会 从 模块 图 中 消失 。 

现在 关注 第 二 点 ， 并 且 考 虑 部 分 模块 化 依赖 需要 访问 的 模块 。 如 果 你 或 其 他 模块 都 不 需要 ， 
它们 就 不 会 出 现在 模块 图 中 ,这 导致 依赖 无 法 访问 它们 。 在 这 种 情况 下 ,你 可 以 在 模块 描述 符 中 
指定 对 它们 的 依赖 ( 别 忘 了 加 一 个 注释 说 明 为 什么 要 这 样 做 )， 也 可 以 在 编译 时 和 启动 时 用 命令 
行 参数 添加 它们 。9.2.2 节 和 9.2.3 节 将 根据 具体 场景 简要 讨论 相应 的 利弊 。 

另外 一 个 障碍 是 自动 模块 通过 公有 API 公开 的 类 型 。 假 设 某 个 项 目 (一 个 模块 化 JAR ) 依 
赖 于 一 个 类 库 (一 个 普通 JAR )， 这 个 类 库 有 一 个 返回 Guava ( 同样 是 一 个 普通 JAR ) 中 
ImmutableList 对 象 的 方法 。 












































































































































public ImmutableList<String> getAl1TheStrings() { 
fy oi 
} 


如 果 将 这 个 项 目 连同 这 个 类 库 放 置 于 模块 路 径 中 , 并 将 Guava 放置 于 类 路 径 中 , 会 得 到 图 8-11 
中 展示 的 模块 图 : 这 个 项 目 〈 清 晰 模块 ) 读 取 这 个 类 库 〈 自动 模块 )， 后 者 又 读 取 无 名 模块 ( 包 
含 Guava )。 此 时 如 果 代 码 调用 返回 ImmutableList 对 象 的 方法 ， 那 么 针对 这 个 类 型 的 可 访问 
性 检查 就 不 会 按照 你 的 期 望 完 成 ， 因 为 你 的 模块 不 会 读 取 这 个 无 名 模块 。 
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requires 


yourapp 


SomeClass 
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现在 ，your.app 中 的 

SomeClass 从 无 名 
your.app 不 会 读 取 无 名 模块 ， 所 以 模块 处 得 到 了 一 个 
它 无 法 访问 ImmutableList， 这 ImmutableLiet 
会 导致 yourapp 出 现 运行 时 错误 对 象 














图 8-11 如 果 一 个 自动 模块 (本 例 中 是 org.lib ) 中 的 某 个 方法 返回 了 无 名 模块 中 的 类 型 
( ImmutableList ), 那么 具名 模块 (your.app ) 将 无 法 访问 它 ， 因 为 它们 不 会 
读 取 无 名 模块 。 如 果 该 方法 声明 返回 无 法 访问 的 类 型 ( ImmutapleList ), 这 
将 导致 应 用 程序 崩 演 ， 而 声明 一 个 超 类 型 ( 这 里 很 可 能 是 List ) 则 可 以 正常 
工作 


这 并 不 是 全 新 的 概念 。 如 果 ImmutableList 是 该 类 库 中 的 一 个 非 公 有 类 型 , 那么 由 于 缺乏 
可 见 性 ， 你 也 无 法 调用 这 个 方法 。 与 本 例 中 一 样 ， 它 与 所 声明 的 返回 类 型 相关 。 如 果 该 方法 声明 
返回 一 个 List 类 型 ， 并 且 选 择 ImmutableList 作为 具体 返回 类 型 ， 那 么 一 切 正 常 。 这 与 API 
声明 的 类 型 相关 ， 而 非 其 返回 的 类 型 。 

因此 ， 如 果 一 个 自动 模块 公开 了 来 自 于 另 一 个 JAR 的 类 型 ， 那 么 这 个 JAR 也 需要 被 放 入 模 
块 路 径 中 。 和 否则 ， 它 的 类 型 会 包含 在 无 名 模块 中 ， 无 法 被 清晰 模块 访问 。 这 会 导致 
IllegalAccessError 错误 ， 原 因 是 缺少 可 读 性 边 ， 正 如 3.3.3 节 所 讲述 的 那样 。 

如 果 具 名 模块 需要 访问 无 名 模块 的 情况 无 法 避免 , 那么 你 只 剩 下 一 个 选项 一 一 照 这 个 需求 的 
字面 意义 去 做 。3.4.4 节 介 绍 的 命令 行 选项 --add-reags 在 指定 目标 值 为 ALL-UNNAMED 时 ， 可 
以 添加 一 个 从 具名 模块 到 无 名 模块 的 可 读 性 边 。 这 将 使 你 的 模块 化 代码 与 不 可 预测 的 类 路 径 中 的 
内 容 耦 合 到 一 起 ， 所 以 这 是 万 不 得 已 的 选项 。 

使 用 --add-reads 后 ， 前 面 提 到 的 例子 ( Guava 在 类 路 径 中 并 且 自 动 模块 返回 一 个 
ImmutableList ) 终于 可 以 工作 了 。 如 果 所 接收 的 ImmutableList 实例 (并 且 接 下 来 无 法 通 
过 可 访问 性 检查 ) 的 清晰 模块 名 为 app ， 那 么 对 编译 器 和 运行 时 添加 --add-reads 
app=ALL-UNNAMED 选项 ， 可 以 保证 应 用 程序 正常 工作 。 

介绍 了 这 么 多 , 那么 在 各 种 情况 下 应 该 选择 何 种 路 径 呢 ? 应 该 无 条 件 选 择 自 动 模块 , 还 是 应 
该 倾向 于 在 类 路 径 中 保留 尽 可 能 多 的 依赖 ?下 文 会 对 这 个 问题 进行 讨论 。 
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8.3.3 ”无条件 选择 自动 模块 


有 了 将 普通 JAR 放置 到 模块 路 径 中 将 它们 转变 为 自动 模块 的 方法 ， 人 们 是 否 仍 然 需 要 类 路 
径 ? 难道 不 能 将 所 有 JAR 放置 到 模块 路 径 中 ，( 根据 是 否 包 含 描述 符 ) 将 它们 转变 为 清晰 模块 或 
自动 模块 吗 ? 从 技术 上 说 ,是 的 ,可 以 这 么 做 。 尽 管 如 此 ， 本 书 并 不 推荐 这 种 做 法 ， 下 面 来 解释 


1. 普通 JAR 无 法 构造 良好 的 模块 
总 的 来 说 ， 普 通 JAR 无 法 构造 良好 的 模块 ， 原 因 如 下 : 
口 它们 可 能 访问 JDK 内 部 API (参见 7.1 欧 ; 
口 它们 可 能 在 自身 和 JEE 模块 间 造成 包 分 裂 (参见 7.2 家 ; 
口 它们 无 法 表达 自身 的 依赖 。 
如 果 它 们 转变 为 自动 模块 ， 模 块 系统 就 会 将 相应 的 规则 强加 于 这 些 自动 模块 ， 这 样 你 就 要 花 
大 量 时 间 来 解决 由 此 带 来 的 诸多 问题 。 而 这 些 问 题 中 最 典型 一 个 就 是 ， 一 旦 某 个 普通 JAR 被 升级 
为 模块 化 JAR， 它 就 不 再 被 默认 解析 ( 参见 表 8-2 和 图 8-10 )， 所 以 针对 项 目 依 赖 树 上 每 个 这 样 的 
升级 ， 你 将 不 得 不 手动 添加 依赖 。 自 动 模块 的 唯一 好 处 是 , 它们 可 以 被 清晰 模块 所 需要 , 但 是 如 果 
你 不 需要 这 一 特性 ， 那 么 将 所 有 普通 JAR 转变 为 自动 模块 所 带 来 的 回报 与 麻烦 相 比 将 不 值 一 提 。 
另 一 方面 ， 如 果 将 它们 保留 在 类 路 径 中 ， 那 么 这 些 JAR 会 被 转化 为 无 名 模块 ， 这 样 一 来 : 
D 在 至 少 一 个 Java 发 行 版 本 中 ， 非 法 访问 在 默认 情况 下 得 到 了 人 允许 ; 
口 JAR 之 间 的 分 裂 不 会 造成 影响 ， 但 JAR 和 平台 模块 间 的 分 裂 仍 会 导致 问题 ; 
口 如 果 它 们 包含 应 用 程序 人 口 ， 则 可 以 读 取 所 有 Java SE 平台 模块 ; 
口 当 普通 JAR 被 升级 为 模块 化 JAR 时 ， 不 用 做 任何 事情 。 
这 让 开发 工作 变 得 更 简单 。 
要 点 尽管 把 任何 事情 都 作为 模块 处 理 很 让 人 兴奋 ， 但 本 书 仍然 建议 你 尽量 少 
(项 目 可 以 正常 工作 即 可 ) 把 普通 JAR 放 在 模块 路 径 中 ， 其 余 的 仍 应 放置 在 类 路 
径 中 。 


从 另 一 方面 讲 , 一 个 自动 模块 的 模块 化 依赖 需要 被 放置 在 模块 路 径 中 。 因 为 它们 是 作为 模块 
化 JAR 出 现 的 ， 所 以 不 需要 模块 系统 像 对 待 无 名 模块 那样 宽大 地 对 符 它 们 。 如 果 作 为 模块 加 载 ， 
它们 会 从 可 靠 配置 和 强 封装 中 得 到 好 处 。 


2. 自动 模块 作为 连接 类 路 径 的 桥梁 

针对 更 少 使 用 自动 模块 ， 有 一 个 哲学 观点 : 这 将 它们 转变 为 连接 模块 化 世界 和 混乱 的 类 路 径 
世界 的 桥梁 。 诸多 模块 处 于 桥 的 这 一 侧 , 它们 的 直接 依赖 为 自动 模块 , 而 间接 依赖 在 桥 的 男 一 侧 。 
每 当 有 一 个 依赖 被 转变 为 清晰 模块 时 , 它 就 从 桥 上 移动 到 模块 化 的 那 一 侧 , 并 将 它 的 直接 依赖 作 
为 自动 模块 拉 到 桥 上 。 这 就 是 前 文 提 到 过 的 自 上 而 下 的 方式 ，9.2 节 在 讨论 模块 化 策略 时 将 进 一 
步 对 其 进行 观察 。 
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8.3.4 依赖 自动 模块 


自动 模块 唯一 的 目标 是 让 代码 可 以 依赖 于 普通 JAR, 这 样 无 须 等 待 所 有 依赖 都 被 模块 化 就 能 
创建 清晰 模块 。 但 这 里 有 一 条 重要 的 忠告 : 如 果 JAR 的 manifest 文件 中 没有 包含 Automatic- 
Mogdule-Name 字段 ， 那 么 依赖 会 很 脆弱 。 

正如 8.3.1 节 所 解释 的 ， 没 有 这 个 字段 ， 自 动 模块 的 名 称 就 是 由 文件 名 推断 出 来 的 。 但 是 ， 
根据 设置 ,不 同 的 项 目 中 同一 个 JAR 会 使 用 不 同 的 名 称 。 此 外 ,大 多 数 项 目 会 使 用 一 个 基于 Maven 
的 本 地 仓库 。 在 仓库 中 ，JAR 文件 会 按照 $ a $s {version} 的 方式 命名 ， 而 模块 系 
统 很 可 能 将 其 中 的 $ {artifactID} 作 为 自动 模块 的 名 称 。 这 就 会 造成 问题 ,因为 工件 ID 通常 不 遵循 
3.1.3 节 定 义 的 反 向 域名 命名 规则 : 一 旦 项 目 被 模块 化 ， 模 块 名 很 有 可 能 会 改变 。 

由 于 Google 的 Guava 被 广泛 使 用 ， 本 书 仍然 会 将 它 作 为 一 个 典型 的 例子 。 如 之 前 所 见 ， 对 
于 guava-20.0.jar,， 模块 系统 推导 出 guava 作为 自动 模块 名 称 。 这 是 Maven 本 地 仓库 中 的 文 
件 名 称 ， 但 是 在 其 他 项 目 中 可 能 会 有 不 同 的 设置 。 

假设 命名 规则 为 StfgroupID}-s${tartifactID}-s${tversion}j， 这 样 ,JAR 文 件 将 被 命名 为 
com.google.guava-guava-20.0.jar， 而 自动 模块 名 称 为 com.google.guava.guava。 男 外 ， 一 个 模块 化 
的 Guava 会 被 命名 为 com.google.common， 所 以 没有 一 个 自动 模块 的 名 称 是 正确 的 。 

总 的 来 说 ， 同 一 个 JAR 在 不 同 项 目 ( 依赖 于 项 目 设 置 ) 中 ,或 者 在 不 同时 间 ( 模块 化 前 后 ) 
可 能 会 有 不 同 的 模块 名 。 这 有 可 能 造成 很 大 的 问题 。 

思考 一 下 你 最 喜欢 的 项 目 。 想象 一 下 ， 某 个 依赖 以 自动 模块 的 形式 引用 了 它 的 一 个 依赖 ， 而 
这 个 自动 模块 的 名 称 没 有 遵循 项 目 设 置 (如 图 8-12 所 示 )。 也 许 这 个 依赖 以 $s {groupID}- 
Ss{artifactID}-s {version} 命 名 文件 ， 而 你 所 使 用 的 Maven 的 命名 规则 为 $ {artifactID}- 
$s {version}。 现在 这 个 依赖 需要 自动 模块 ${groupID}.${artifactID}, 但 是 模块 系统 会 在 你 的 项 目 
中 用 $fartifactID} 进 行 推断 。 这 会 让 构建 失败 一 一 虽然 有 一 些 办 法 能 够 将 其 修复 (参见 9.3.3 前 ， 
但 没有 一 个 是 令 人 愉快 的 。 


( ) 有 requires 自动 模块 
A gal com.google.guava.guava h 















































了 JPMS 推 新 出 的 名 称 不 同 
orglibi 通过 另 一 个 名 称 依赖 
Guava 这 个 配置 无 法 


加 载 


8-12 依赖 org.lib 通过 构建 过 程 中 得 到 的 自动 模块 名 称 (com.google.guava.guava ) 
依赖 于 Guava。 但 很 不 幸 ， 在 系统 中 ， 这 个 工件 叫 作 guava.jar， 所 以 模块 
名 为 guava。 如 果 不 进 一 步 采 取 措 施 ， 模 块 系统 会 抱怨 依赖 丢失 


不 仅 如 此 ,事情 还 会 变 得 更 糟糕! 还 是 在 同一 个 项 目 中 ,如果 添加 男 一 个 依赖 ， 而 这 个 依赖 
需要 同一 个 自动 模块 ,但 是 使 用 了 不 同 的 名 称 ( 如 图 8-13 所 示 )， 这 就 是 3.2.2 节 提 到 的 模块 的 
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死亡 之 眼 : 同一 个 JAR 无 法 满足 针对 不 同名 称 的 模块 的 需求 ， 并 且 多 个 相同 内 容 的 JAR 由 于 针 
对 包 分裂 的 规则 而 无 法 工作 。 请 不 惜 一切 代 价 来 避免 这 种 情况 ! 


不 论 JPMS 为 Guava 的 普通 JAR 


推断 出 哪个 模块 名 称 …… 









以 … 它 都 无 法 同时 满足 
这 两 个 依赖 
图 8-13 ” 另 一 个 依赖 ， 即 com.framework， 也 依赖 于 Guava， 但 是 使 用 了 不 同 的 名 称 
(guava )。 现 在 ， 同 一 个 JAR 需要 以 两 个 不 同 的 具名 模块 的 形式 出 现 一 一 这 是 
不 可 能 的 

看 起 来 , 关键 性 的 错误 在 于 通过 一 个 基于 文件 名 的 模块 名 称 来 依赖 一 个 普通 JAR。 但 实际 情 
况 并 不 是 这 样 一 一 如 果 开 发 者 能 完全 掌控 此 类 自动 模块 的 模块 描述 符 , 那 这 种 方法 在 应 用 程序 中 
或 者 其 他 场景 中 是 没 问 题 的 。 

“ 压 震 骆驼 的 最 后 一 根 稻草 ”是 将 带 有 这 种 依赖 的 模块 发 布 到 一 个 公共 仓库 。 只 有 在 这 种 情 
况 下 ,用 户 才 有 可 能 将 模块 明确 依赖 到 无 法 控制 的 细节 上 ， 进 而 不 得 不 采取 额外 的 措施 ,其 至 导 
致 无 法 解决 的 冲突 。 

结论 是 ， 如 果 模 块 依赖 于 manifest 文件 中 不 包含 Automatic-Module-Name 字段 的 普通 
JAR， 请 永远 不 要 将 这 样 的 模块 发 布 到 可 公开 访问 的 仓库 ， 因 为 只 有 带 有 这 个 字段 ， 自 动 模块 的 
名 称 才 足 够 稳定 、 值 得 依赖 。 

是 的 , 这 也 许 意味 着 你 不 能 为 类 库 或 者 框架 发 布 模块 化 的 版 本 ,而 只 能 等 待 依赖 添加 这 个 字 
段 。 这 很 不 幸 ， 但 是 草率 地 发 布 模块 化 版 本 会 对 你 的 用 户 产生 很 大 伤害 。 


提示 “关于 迁移 和 模块 化 ， 本 书目 前 已 经 介绍 了 能 够 影响 现 有 代码 的 所 有 挑战 和 机 制 。 
第 9 章 将 继续 探索 对 它们 的 最 佳 实践 。 之 后 ， 第 三 部 分 会 讲授 模块 系统 更 高 级 的 特性 。 






























































8.4 小 结 


口 在 增 量 模块 化 的 过 程 中 ， 人 们 往往 会 使 用 类 路 径 和 模块 路 径 。 理 解 以 下 两 点 非常 重要 : 
类 路 径 中 的 任何 JAR (普通 JAR 或 模块 化 JAR ) 都 会 被 转换 成 无 名 模块 ; 模块 路 径 中 的 
任何 JAR 都 会 被 转换 成 具名 模块 ， 即 自动 模块 ( 对 于 普通 JAR 来 说 ) 或 者 清晰 模块 ( 对 
于 模块 化 JAR 来 说 )。 这 使 JAR 的 用 户 ( 而 非 它 的 创建 者 ) 能 够 决定 它 是 否 要 变 成 一 个 
具名 模块 。 
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口 无 名 模块 是 一 种 兼容 性 特性 ， 能 够 让 模块 系统 与 类 路 径 一 起 工作 。 

时 它 没有 名 称 ， 会 抓 取 类 路 径 中 的 内 容 、 读 取 所 有 其 他 模块 、 导 出 和 开放 所 有 包 。 

时 因为 没有 名 称 ， 清 晰 模块 无 法 在 模块 描述 符 中 对 其 进行 引用 。 一 个 后 果 就 是 ， 它 们 无 
法 读 取 无 名 模块 ， 并 因此 无 法 使 用 类 路 径 中 定义 的 类 型 。 

昌 如 果 无 名 模块 是 一 个 初始 模块 ， 就 会 有 一 系列 特定 规则 保证 正确 的 模块 集合 得 到 解析 。 
总 体 上 说 ， 这 些 都 是 非 JEE 模块 及 其 依赖 。 这 使 得 类 路 径 中 的 代码 无 须 进 一 步 配置 即 
可 读 取 所 有 的 Java SE API， 以 实现 兼容 性 的 最 大 化 。 

口 自动 模块 是 一 种 迁移 特性 ， 能 够 使 模块 依赖 于 普通 JAR。 

m 模块 系统 会 为 模块 路 径 中 的 每 个 JAR 创建 一 个 自动 模块 。 它 的 名 称 通 过 JAR manifest 
文件 中 的 Automatic-Module-Name 字段 定义 ,如 果 没 有 这 个 字段 ， 则 从 JAR 的 文件 
名 中 获取 。 它 读 取 包 括 无 名 模块 在 内 的 所 有 其 他 模块 ， 并 且 导 出 和 开放 所 有 包 。 

@ 由 于 它 是 一 个 普通 的 具名 模块 ， 因 此 可 以 在 模块 声明 中 被 引用 ， 比 如 指明 对 它 的 依赖 。 
这 使 正在 被 模块 化 的 项 目 可 以 依赖 于 尚未 被 模块 化 的 项 目 。 

和 一 个 自动 模块 的 依赖 可 以 放置 在 类 路 径 中 或 者 模块 路 径 中 。 尽 管用 哪个 路 径 要 取决 于 
项 目的 具体 情况 ,但 是 默认 方式 是 将 模块 化 依赖 放置 在 模块 路 径 中 ， 将 普通 依赖 放置 
在 类 路 径 中 ， 这 也 是 较为 合理 的 方式 。 

里 [着 着 第 一 个 自动 模块 得 到 解析 ， 其 他 自动 模块 也 将 逐一 被 解析 。 进 而 ， 任 何 模块 只 要 
读 取 一 个 自动 模块 ， 就 会 根据 隐 式 可 读 性 读 取 所 有 自动 模块 。 在 测试 对 自动 模块 的 依 8 
赖 时 ， 这 个 情况 要 考虑 在 内 。 






















































































会 全 面 





Ee 


本 音 后 , 你 不 仅 会 理解 迁移 挑战 和 模块 化 特 怕 


迁移 和 模块 化 策略 








本 章 内 容 

口 准备 迁移 到 Java 9 或 更 高 版 本 

口 持续 集成 变化 

口 增 量 模块 化 项 目 

口 利用 JDeps 生成 模块 声明 

口 用 jar 工具 破解 第 三 方 JAR 

口 为 Java 8 或 更 早 版 本 发 布 模块 化 JAR 




















第 6 章 、 第 7 章 和 第 8 章 讨论 了 迁移 到 Java 9 及 以 上 版 本 ， 以 及 将 已 有 代码 转化 为 模块 化 代 
码 的 技术 细节 。 本 章 视 角 更 广 , 主要 探寻 如 何 将 这 些 细节 整合 为 成 功 的 迁移 和 模块 化 成 果 。 首先 ， 
本 章 将 讨论 如 何 进 行 渐进 式 迁 移 , 实现 迁移 与 开发 过 程 的 良好 配合 , 尤其 是 构建 工具 和 持续 集成 。 
接 下 来 ， 本章 会 探寻 如 何 使 用 无 名 模块 和 自动 模块 作为 特定 模块 化 策略 的 构成 要 素 。 最 终 ， 本 章 












































方法 [3 


9.1 


挑战 


迁移 策略 





介绍 将 JAR 进行 模块 化 的 不 同 选 项 ( 不论 是 自己 项 目的 JAR 还 是 受 依赖 的 JAR )。 完 成 
FE 背后 的 机 制 , 也 会 掌握 在 自己 的 项 目 中 利用 它们 的 


有 了 在 第 6 章 和 第 7 章 积累 的 知识 , 你 已 经 准备 好 迎接 Java 9 及 以 上 版 本 在 各 个 方面 提出 的 


























了 。 现在 是 时 候 扩 展 你 的 视野 并 制定 一 个 更 宏大 的 策略 了 。 如 何 安排 这 些 代码 和 碎片 才能 作 











迁移 尽 可 能 地 彻底 和 可 控 ? 本 方 将 针对 迁移 准备 、 迁 移 工 作 量 评估 、 基 于 Java 9 及 以 上 版 本 的 持 


续 构 


建 搭建 ， 以 及 命令 行 选项 的 缺点 给 出 建议 。 


注意 本 节 的 很 多 话题 与 构建 工具 相关 。 由 于 各 种 工具 已 尽量 保持 通用 ,因此 本 节 不 要 
求 你 了 解 任 何 特定 的 工具 。 但 同时 ,我 想 分 享 使 用 Maven ( 到 目前 为 止 我 在 Java9 及 以 
上 版 本 中 用 过 的 唯一 构建 工具 ) 的 经 验 ， 所 以 本 节 会 不 时 地 指出 哪些 Maven 的 特性 可 
以 满足 相应 的 需求 。 这 部 分 内 容 不 会 涉及 任何 细节 ， 所 以 你 需要 自己 挖 报 这 些 特性 的 工 
作 原 理 。 





9.1.1 更 新 准备 


首先 ， 如 果 还 未 使 用 Java 8， 那 你 应 该 先 升 级 到 Java 8。 循 序 渐进 ， 不 要 一 次 跳跃 两 个 或 更 
多 版 本 ,这 是 为 了 你 自己 好 。 先 进行 一 次 升级 ,让 所 有 工具 和 流程 正常 工作 ,并 在 生产 环境 中 运 
行 一 段 时 间 ， 然 后 开始 下 一 步 升 级 。 如 果 想 从 Java 8 升级 到 Java 11， 也 是 同样 的 道理 一 一 每 次 
前 进一步 。 如 果 遇 到 问题 ， 你 一 定 想 知道 是 哪个 Java 版 本 或 依赖 升级 所 导致 的 。 

谈 到 依赖 , 还 有 一 件 事 不 需要 了 解 Java 9 及 以 上 版 本 就 可 以 做 : 升级 这 些 依赖 以 及 你 所 用 的 
工具 。 除 了 持续 更 新 的 常见 好 处 ,你 还 可 能 无 意 间 从 一 个 在 Java9 及 以 上 版 本 中 会 出 现 问题 的 版 
本 升级 到 能 在 Java9 及 以 上 版 本 中 正常 工作 的 版 本 。 这 时 你 甚至 不 会 注意 到 曾经 遇 到 过 问题 。 如 
果 你 的 依赖 或 工具 还 没有 发 布 与 Java9 及 以 上 版 本 兼容 的 版 本 ,让 它们 处 于 最 新 的 版 本 ,这 在 将 
来 仍然 会 使 更 新 到 Java 9 及 以 上 版 本 的 兼容 版 本 更 容易 。 
















































































AdoptOpenJDK 质量 延伸 
AdoptOpenJDK,“ 一 个 由 Java 用 户 组 成 员 、Java 开发 者 和 倡导 OpenJDK 的 供应 商 组 成 的 
社区 ”， 列 出 了 一 系列 开源 项 目 以 及 它们 在 最 新 的 和 下 一 个 Java 版 本 中 的 工作 成 就 。 


9.1.2 ”工作 量 评估 


有 几 种 方法 可 以 帮助 你 了 解 接 下 来 会 有 哪些 工作 , 我 们 首先 会 关注 这 些 方法 ; 然后 会 对 发 现 
的 问题 进行 评估 和 分 类 ; 最 终 ， 本 闻 会 以 一 个 具体 的 佑 算数 字 结 束 。 


1. 寻找 问题 

以 下 是 在 收集 问题 时 可 以 采用 的 一 些 明显 选 项 。 

口 将 构建 配置 为 对 Java 9 及 以 上 版 本 进行 编译 和 测试 (Maven: toolchain )。 最 好 能 让 人 们 

收集 所 有 错误 方式 ， 而 不 是 遇 到 错误 就 退出 (Maven: --fail-never )。 

口 在 Java 9 及 以 上 版 本 中 运行 整个 构建 (Maven: ~/ .mavenrc )。 同 样 ， 收 集 所 有 错误 。 

口 如 果 正 在 开发 一 个 应 用 程序 ， 请 像 平 时 一 样 构建 它 〈 即 不 在 Java 9 及 以 上 版 本 中 构建 )， 
然后 在 Java9 及 以 上 版 本 中 运行 。 使用--illegal-access=debug 或 deny 来 获取 关于 
非法 访问 的 详细 信息 。 

仔细 分 析 这 些 输出 , 记录 下 新 的 警告 和 错误 , 并 试 着 将 它们 与 前 面 章 节 中 所 讨论 的 内 容 联 系 
起 来 。 留 意 6.5.3 节 描 述 的 那些 被 移 除 的 命令 行 选项 。 

最 好 应 用 一 些 快速 修复 方法 ,比如 添加 导出 或 JEE 模块 , 这 样 你 将 有 机 会 看 到 藏匿 于 表面 问 
题 之 下 的 “项 疾 ”。 在 这 个 阶段 ， 任 何 修 复 都 不 会 显得 草率 或 者 不 合理 一 一 任何 能 够 让 构建 抛 出 
新 错误 的 办 法 都 是 一 次 胜利 。 如 果 遇 到 了 太 多 的 编译 错误 ， 你 则 可 以 基于 Java 8 进行 编译 , 然后 
在 Java 9 及 以 上 版 本 中 执行 测试 (Maven: mvn surefire:test )。 

接 下 来 , 对 项 目 以 及 依赖 执行 JDeps。 对 JDK 内 部 API 进行 依赖 分 析 (参见 7.1.2 节 ), 并 对 JEE 
模块 进行 记录 (人 参见 6.1 节 )。 同 时 寻找 平台 模块 与 应 用 程序 JAR 之 间 的 包 分 裂 (参见 7.2.5 节 )。 
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最 后 , 在 代码 中 搜索 对 Accessibleobject::setaAccessible 的 调用 (参见 7.1.4 掀 、 对 
URLClassLoagder 的 类 型 转换 (参见 6.2 节 )、 对 java.version 系统 属性 的 解析 (参见 6.5.1 
节 ), 或 者 手动 完成 的 资源 URL (参见 6.3 节 )。 将 找到 的 所 有 内 容 放 到 一 个 大 列表 中 一 一 现在 是 
时 候 对 它 进 行 分 析 了 。 


2. 这 有 多 精 糕 

你 找到 的 问题 可 以 归结 为 两 类 :“ 我 在 本 书 中 见 过 它 ” 和 “这 是 什么 鬼 玩意 ”前 者 可 以 进 
一 步 归 类 为 “这 里 至 少 有 临时 的 解决 方案 ”和 “这 是 个 很 坏 手 的 问题 ”。 下 面 是 两 个 最 难 解决 的 
问题 : 

(1) 被 移 除 的 API; 

(2) 平台 模块 和 某 些 JAR 之 间 的 包 分 裂 ， 而 这 些 JAR 没有 实现 授权 标准 或 独立 技术 。 

千 万 不 要 将 普遍 性 与 重要 性 混淆 ! 也 许 你 会 遇 到 1000 个 关于 JEE 模 块 缺 失 的 错误 ， 但 是 修复 
这 样 的 错误 非常 容易 。 而 男 一 方面 ， 如 果 核 心 功能 依赖 于 应 用 程序 类 加 载 器 对 URLClassLoader 
的 类 型 转换 ， 你 会 麻烦 缠身 。 当 然 也 有 这 样 的 情况 : 尽管 你 对 某 个 被 移 除 的 API 有 关键 性 依赖 ， 
但 是 由 于 良好 的 设计 ， 这 可 能 只 在 某 个 子 项 目 中 造成 了 一 两 个 编译 错误 。 

一 个 更 好 的 办 法 是 ， 在 面 对 每 个 不 知道 如 何 解 决 的 问题 时 都 问 一 下 自己 :“ 如 果 删 掉 有 问题 
的 代码 以 及 所 有 依赖 于 这 些 代码 的 功能 会 有 多 糟糕 ? ”这 将 对 你 的 项 目 产 生 什 么 样 的 影响 ? 同 
样 ， 有 没有 可 能 临时 屏蔽 掉 有 问题 的 代码 ? 测试 代码 可 以 忽略 ， 功 能 也 可 以 通过 开关 临时 关 掉 。 
请 具备 这 样 的 意识 : 推迟 对 问题 的 修复 ， 先 试 着 在 没有 某 个 功能 的 情况 下 构建 并 运行 应 用 程序 。 

当 完 成 以 上 工作 后 ， 你 会 得 到 包含 如 下 3 类 问题 的 一 个 列表 : 
口 容易 修复 的 已 知 问题 ; 
口 不 容易 修复 的 已 知 问题 ; 
口 需要 调研 的 未 知 问题 。 

对 于 后 两 类 问题 , 你 需要 了 解 它 们 对 项 目的 危害 程度 ,以 及 如 何 绕 开 这 些 问 题 ， 避免 现 在 就 
进行 修复 。 


3. 关于 具体 估算 数字 

有 时 你 可 能 要 对 项 目 进行 评 佑 ， 并 提供 一 些 不 易 给 出 的 数字 ， 也 许 是 工时 ， 也 许 是 工作 量 。 
进行 这 样 的 评估 通常 很 难 ， 而 对 迁移 工作 进行 评估 尤其 困难 。 

向 Java 9 及 以 上 版 本 进行 迁移 会 让 你 重新 面 对 一 些 比较 和 久远 的 决定 。 也 许 你 的 项 目 紧 耦合 于 
某 个 Web 框架 的 早期 版 本 ， 而 几 年 前 你 就 想 升级 它 ; 或 者 它 已 经 积累 了 很 多 技术 债 ， 而 这 些 技 
术 债 都 半 绕 着 某 个 不 再 维护 的 库 。 很 不 幸 ， 它 们 在 Java9 及 以 上 版 本 中 都 不 再 继续 工作 。 你 现在 
需要 偿还 这 些 技术 债 , 每 个 人 都 知道 这 些 债务 的 成 本 和 利率 很 难 评估 。 最后, 就 像 通关 游戏 一 样 ， 
最 终 BOSS 一 一 也 就 是 最 难 对 付 的 敌人 一 一 也 许 隐 藏 在 很 多 其 他 麻烦 之 后 ， 如 果 不 摆 平 前 面 的 从 
子 , 就 无 法 看 到 他 。 不 是 说 这 样 的 场景 一 定 会 出 现 , 而 是 它 有 可 能 出 现 , 所 以 在 猜测 迁移 到 Java9 
需要 多 长 时 间 时 ， 请 尽量 小 心 。 



























































































































































9.1.3 基于 Java 9 及 以 上 版 本 持续 构建 


如 果 你 在 持续 构建 项 目 , 那么 下 一 步 就 是 成 功 搭建 一 个 基于 Java 9 及 以 上 版 本 的 构建 。 这 需 
要 做 很 多 决定 。 
口 构建 哪个 分 支 ? 
口 是 否 应 该 创建 单独 的 版 本 ? 
口 如 果 你 的 应 用 程序 无 法 完全 基于 Java 9 及 以 上 版 本 运行 ， 那 么 要 如 何 对 构建 进行 切 分 ? 
口 如 何 同 时 支持 Java 8 和 Java 9 及 以 上 版 本 的 构建 ? 
最 后 将 由 你 来 找 出 答案 , 并 使 它们 适应 你 的 项 目 和 持续 集成 ( CI ) 设置 。 下 面 我 来 分 享 一 些 
经 验 ， 它 们 曾经 在 我 的 迁移 工作 中 表现 良好 ， 你 可 以 随意 对 它们 进行 组 合 。 


1. 构建 哪个 分 支 
你 也 许 希 望 为 迁移 工作 创建 自己 的 分 支 ， 并 意图 让 CI 服务 器 基于 Java 9 及 以 上 版 本 构建 这 

个 分 支 ， 同 时 〈 和 以 前 一 样 ) 基于 Java 8 构建 其 他 分 支 。 但 是 迁移 需要 时 间 ， 所 以 这 可 能 会 导致 

该 分 支 生 命 周期 很 长 。 通 常 我 会 尽量 避免 这 种 情况 ， 原 因 如 下 : 

口 你 独自 进行 迁移 工作 ， 你 的 改动 不 会 被 整个 团队 持续 检查 ,但 他 们 的 工作 基于 这 些 改 动 ; 

口 因为 两 个 分 支 都 会 产生 很 多 改动 ， 所 以 更 新 或 合并 Java 9 及 以 上 版 本 分 支 时 的 冲突 概率 

会 增加 ; 

口 如 果 需 要 很 长 时 间 来 将 主 开 发 分 支 中 的 改动 合并 到 Java 9 及 以 上 版 本 分 支 ， 那么 其 余 的 
团队 成 员 可 以 自由 添加 更 多 代码 ， 这 会 带 来 针对 Java 9 及 以 上 版 本 的 新 问题 ， 但 是 得 不 
到 任何 及 时 的 反馈 。 

虽然 可 以 在 单独 的 分 支 上 对 迁移 进行 最 初 的 调研 ,建议 你 还 是 尽早 切换 到 主 开发 分 支 , 并 在 

那里 搭建 CI 流程 。 这 确实 需要 对 构建 工具 进行 更 多 的 调 校 ， 因 为 你 需要 通过 Java 版 本 〈 Java 编 

译 器 不 喜欢 未 知 选项 ) 对 配置 的 一 些 部 分 〈 例 如 ， 编 译 器 的 命令 行 选项 ) 进行 隔离 。 


2. 基于 哪个 版 本 构建 

在 Java 9 及 以 上 版 本 中 进行 构建 时 ， 应 该 为 工件 创建 单独 的 版 本 ( 类 似 于 -JAVA-LATEST- 
SNAPSHOT ) 吗 ? 如 果 已 经 决定 创建 单独 的 Java 9 及 以 上 版 本 分 支 ， 你 很 可 能 不 得 不 同时 创建 一 
个 单独 的 版 本 。 和 否则 你 很 容易 将 来 自 于 不 同 分 支 的 快照 (snapshot ) 工件 混淆 ， 进 而 破坏 构建 ， 
分 支 的 偏差 越 大 越 是 如 此 。 如 果 你 已 经 决定 在 主 开 发 分 支 上 进行 构建 ,那么 创建 单独 的 版 本 也 许 
并 不 容易 ; 但 是 我 并 没有 这 样 尝 斌 过， 因为 发 现 没 有 理由 这 么 做 。 

不 论 如何 管 理 版 本 , 在 尝试 让 代码 在 Java 9 及 以 上 版 本 中 工作 时 ,你 都 有 可 能 偶尔 地 在 Java 
8 中 构建 同一 个 子 项 目的 相同 版 本 。 我 反复 在 做 的 一 件 事情 〈 即便 我 决心 不 这 样 做 ) 就 是 ， 将 在 
Java9 及 以 上 版 本 中 构建 的 工件 安装 到 我 的 本 地 仓库 。 像 膝 跳 反射 那样 使 用 mvn clean instal1 
命令 ?这 并 非 一 个 好 主意 : 之 后 你 将 无 法 在 Java 8 中 使 用 这 些 工件 ， 因 为 它 不 支持 Java9 及 以 上 
版 本 的 字 节 码 。 
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当 在 本 地 基于 Java 9 及 以 上 版 本 进行 构建 时 ， 记 得 不 要 安装 这 些 工件 ! 我 使 用 mvn clean 
verify 来 代替 。 


3. 基于 Java 9 及 以 上 版 本 构建 什么 

你 最 终 的 目标 是 基于 Java 9 及 以 上 版 本 运行 构建 工具 , 并 且 跨 越 所 有 的 阶段 或 任务 来 构建 所 
有 的 项 目 。 根 据 之 前 创建 的 问题 列表 中 问题 的 数量 , 你 可 能 仅 需要 做 很 少 的 改动 就 能 达成 这 个 目 
标 。 这 种 情况 下 ,大胆 一 试 吧 一 一 没有 必要 把 过 程 复 杂 化 。 如 果 你 的 问题 列表 很 长 ， 下 面 有 几 个 
办 法 可 以 将 Java 9 构建 进行 切 分 : 







































































口 可 以 在 Java 8 中 执行 构建 ， 而 仅 在 Java 9 及 以 上 版 本 中 执行 编译 和 测试 ， 很 快 本 章 将 对 
其 进行 讨论 ; 

口 可 以 按照 目标 或 任务 进行 迁移 ， 即 在 进行 测试 之 前 ， 先 尝试 基于 Java 9 及 以 上 版 本 编译 
整个 项 目 ; 

口 可 以 按照 子 项 目 进行 迁移 ， 即 先 尝 试 为 一 个 完整 的 子 项 目 进行 编译 、 测 试 和 打包 ， 然 后 
再 切换 到 下 一 个 。 


总 的 来 说 ， 对 于 庞大 且 不 可 拆 分 的 项 目 ,本 书 推荐 “按照 目标 或 任务 ”的 方式 ; 而 对 于 可 以 
拆 分 得 足够 小 的 项 目 〈 每 个 子 项 目 都 可 以 一 次 性 搞定 )， 本 书 推荐 “按照 子 项 目 ” 的 方式 。 

在 选择 按照 子 项 目 构建 时 , 只 要 其 中 一 个 子 项 目 因为 某 种 原因 无 法 在 Java 9 及 以 上 版 本 中 进 
行 构建 ， 你 就 无 法 容易 地 构建 依赖 于 它 的 子 项 目 。 我 曾 遇 到 过 这 种 情况 ， 并 因此 决定 将 Java9 构 
建设 置 为 两 次 执行 : 

(1) 在 Java 8 中 构建 一 切 ; 

(2) 在 Java9 及 以 上 版 本 中 构建 一 切 ， 有 问题 的 子 项 目 除外 (依赖 于 它 的 其 他 子 项 目 将 基于 它 
在 Java 8 中 构建 的 版 本 进行 构建 )。 


4. 基于 Java 9 及 以 上 版 本 的 构建 工具 

在 项 目 被 完全 迁移 到 Java 9 及 以 上 版 本 之 前 ,你 也 许 经 常 需要 将 构建 在 Java8 和 Java9 及 以 
上 版 本 之 间 切 换 。 下面 看 一 下 如 何 为 你 所 选择 的 构建 工具 配置 Java 版 本 ， 而 不 需要 为 整个 机 器 
(Maven: ~/ .mavenrc 或 者 工具 链 ) 设置 默认 Java 版 本 。 之 后 ， 考 虑 如 何 将 切换 自动 化 。 我 
最 终 写 了 一 个 小 脚本 , 用 来 将 SIJAVA_HOME 设置 为 JDK 8 或 JDK9 及 以 上 版 本 ,以便 可 以 快速 选 
择 需 要 的 版 本 。 

接 下 来 , 同时 也 是 个 小 的 中 间 过 程 ,构建 工具 也 许 不 能 在 Java 9 及 以 上 版 本 中 正常 工作 : 也 
许 构建 工具 需要 一 个 JEE 模块 ， 也 许 某 个 插件 使 用 了 被 移 除 的 API。( 我 在 使 用 Maven 的 一 个 
JAXB 插件 时 遇 到 了 这 个 问题 ， 它 需要 java.xml.bind 并 且 依 赖 于 其 内 部 代码 。) 

这 种 情况 下 ， 可 以 考虑 在 Java 8 中 执行 构建 ， 并 在 Java 9 及 以 上 版 本 中 仅 执行 编译 和 测试 。 
但 是 如 果 构 建 在 自身 的 流程 中 ( Java 8 ) 使 用 所 创建 的 Java 9 及 以 上 版 本 字 节 码 进行 了 操作 ， 这 
个 办 法 将 不 会 起 作用 。( 我 在 使 用 Java 远程 方法 调用 编译 器 rmic 时 遇 到 了 这 个 问题 ; 它 迫 使 我 
们 在 Java 9 及 以 上 版 本 中 执行 整个 构建 ， 尽 管 我 们 并 不 想 这 么 做 。) 
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如 果 你 决定 在 Java9 及 以 上 版 本 中 执行 构建 ,而 该 工作 并 不 顺利 , 你 将 不 得 不 用 一 些 新 的 命 
令 行 选项 来 配置 构建 流程 。 这 么 做 可 以 帮助 团队 成 员 更 容易 地 ( 没 人 愿意 手动 添加 选项 ) 使 它 在 
Java 8( 不 文 持 新 的 选项 ) 中 继续 工作 , 但 是 这 并 不 是 一 件 容易 的 事情 ( Maven: jvm.config )。 
我 发 现 如 果 不 更 改 文件 名 ， 就 无 法 让 它 在 两 个 版 本 中 同时 工作 ， 所 以 不 得 不 在 “切换 Java 版 本 ” 
脚本 中 加 入 了 更 改 文件 名 的 逻辑 。 


5. 如 何 配 置 Java 9 及 以 上 版 本 的 构建 

当 必 须 为 编译 器 、 测 试 运行 时 或 者 任何 其 他 构建 任务 添加 与 版 本 相关 的 配置 选项 时 , 你 如 何 
确保 Java 8 构建 和 Java 9 及 以 上 版 本 构建 都 可 以 执行 ? 你 的 构建 工具 应 该 可 以 帮忙 。 它 很 有 可 能 
人 带 有 某 个 特性 ， 方 便 你 将 总 的 配置 针对 不 同 的 情况 进行 适 配 (Maven: profiles )。 熟 悉 一 下 这 个 
功能 ， 因 为 你 将 很 可 能 经 常用 到 它 。 

在 使 用 针对 JVM 的 与 版 本 相关 的 命令 行 选项 时 ， 有 一 个 选项 是 使 用 构建 工具 对 它们 进行 分 
类 : 使 用 非 标准 JVM 选项 -xx:+IgnoreUnrecognizedVvMOptions， 你 可 以 命令 正在 启动 的 虚 
拟 机 忽略 未 知 的 命令 行 选项 ( 这 个 选项 对 编译 器 不 可 用 )。 虽 然 这 使 得 你 可 以 对 Java 8 和 Java 9 
及 以 上 版 本 使 用 相同 的 命令 行 选项 , 但 本 书 还 是 不 建议 把 它 作 为 首选 项 , 因为 其 关 掉 了 有 助 于 避 
免 错 误 的 检查 。 相 反 ， 本 书 推荐 尽 可 能 通过 版 本 来 隔离 这 些 选 项 。 


6. 在 两 个 路 径 上 都 进行 测试 

如 果 你 正在 处 理 一 个 库 或 框架 ， 那 么 无 法 控制 用 户 将 你 的 JAR 放置 到 类 路 径 上 还 是 模块 路 
径 上 。 在 不 同 的 具体 项 目 中 ， 这 可 能 会 导致 一 些 区 别 。 因 此 就 有 必要 对 两 种 情况 分 别 进行 测试 。 

很 抱歉 ， 此 处 我 尚 无 法 给 出 任何 建议 。 在 撰写 本 书 的 时 候 ， 不 论 是 Maven 还 是 Gradle， 都 
不 支持 在 两 个 路 径 上 各 执行 一 次 测试 , 所 以 你 也 许 不 得 不 创建 第 二 个 构建 配置 。 希望 工具 支持 能 
够 随 着 时 间 推 移 得 到 改善 。 


7. 先 修复 ， 后 解决 

在 典型 情况 下 ,Java9 及 以 上 版 本 问题 列表 中 的 大 多 数 问题 比较 容易 借助 命令 行 标志 来 修复 。 
例如 ， 导 出 一 个 内 部 API 非 常 容易 ,但 这 并 没有 解决 潜在 问题 。 有 时 候 ， 解 决 方案 也 很 简单 ， 比 
如 将 内 部 的 sun.reflect.generics.reflectiveObjects.NotImplementedFException 替 
换 为 UnsupportedOperationException (不 是 开玩笑 : 我 曾经 多 次 不 得 不 这 么 做 )， 但 通常 
并 不 是 这 样 。 

应 该 采用 简单 的 快速 修复 , 还 是 使 用 彻底 的 但 需要 更 长 时 间 的 解决 方案 ? 在 尝试 让 完整 构建 
正常 工作 的 阶段 ， 建 议 选择 简单 的 快速 修复 : 
口 在 必要 的 地 方 增加 命令 行 标志 ; 
口 关闭 测试 ， 最 好 仅 针 对 Java 9 及 以 上 版 本 (这 在 JUnit 4 中 可 以 轻松 地 使 用 “假设 ”来 实 
现 ; 在 JUnit 5 中 推荐 使 用 “条 件 ”); 
口 如 果 一 个 子 项 目 使 用 了 被 移 除 的 API， 那 么 将 它 的 编译 和 测试 切换 为 基于 Java 8; 
口 如 果 所 有 其 他 方法 都 失败 了 ， 那 么 跳 过 整个 项 目 。 
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一 个 可 以 正常 工作 的 构建 ， 如 果 能 够 针对 项 目 对 Java9 及 以 上 版 本 的 兼容 性 ( 包括 能 够 实现 
兼容 性 的 临时 捷径 ) 给 予 整个 团队 及 时 的 回馈 , 将 是 非常 有 价值 的 。 为 了 稍 后 对 这 些 临 时 修复 进 
行 改 进 ， 本 书 建议 使 用 某 种 方式 来 标记 它们 。 

我 用 类 似 于 // [JAVA LATEST，<PROBLEM>] : <explanation> 的 注释 来 标记 临时 修复 ， 
这 样 对 JAVA LATEST，GEOTOOLS 进行 全 文 检索 就 可 以 找 出 由 于 GeoTools 的 版 本 与 Java 9 不 兼 
容 而 需要 被 关闭 的 所 有 测试 。 

在 某 些 较 早出 现 的 构建 错误 背后 ， 人 们 经 常 发 现 新 间 题 。 如 果 出 现 了 这 种 情况 ,记得 将 它们 
添加 到 你 的 Java 9 及 以 上 版 本 问题 列表 中 。 同 样 ， 划 掉 那 些 已 经 解决 的 问题 。 


8. 保持 绿色 

一 旦 搭建 好 一 个 成 功 的 构建 , 你 就 应 该 对 所 有 面 对 过 的 Java 9 及 以 上 版 本 的 挑战 有 一 个 完整 
的 认识 。 现 在 是 时 候 逐 一 解决 它们 了 。 

有 些 问题 也 许 很 坏 手 ,或 者 解决 起 来 很 耗 时 ; 甚至 你 会 认为 它们 当下 无 法 解决 一 一 也 许 等 到 
一 个 重要 的 版 本 被 发 布 , 或 者 预算 有 了 一 些 回 旋 余 地 , 才 有 可 能 得 到 解决 。 如 果 解 决 问题 很 耗 时 ， 
请 不 要 着 急 。 因 为 团队 中 的 每 个 开发 者 都 可 以 对 构建 修 修补 补 ， 所 以 你 不 可 能 迈 向 错误 的 方向 。 
即使 要 处 理 的 工作 总 量 很 大 ， 你 的 每 一 步 仍 将 很 小 。 


9.1.4 ”关于 命令 行 选项 的 领悟 


在 使 用 Java9 及 以 上 版 本 时 , 你 可 能 会 比 以 前 应 用 更 多 的 命令 行 选项 一 一 我 就 遇 到 过 这 样 的 
情况 。 关 于 以 下 几 点 ， 我 有 一 些 领 悟 可 以 分 享 : 
口 应 用 命令 行 选 项 的 4 种 方式 ; 
D 依赖 弱 封 装 ; 
口 命令 行 选项 中 的 陷阱 。 
下 面 将 逐一 进行 讲解 。 


1. 应 用 命令 行 选项 的 4 种 方式 

要 应 用 命令 行 选项 ， 最 显而易见 的 方式 是 使 用 命令 行 ， 并 将 选项 追加 到 java 或 javac 之 
后 。 但 你 是 否 知道 ， 除 此 之 外 还 有 另外 3 种 可 能 的 方式 。 

如 果 你 的 应 用 程序 是 以 可 执行 JAR 的 形式 交付 的 ， 那么 使 用 命令 行 就 不 是 一 个 很 好 的 方式 。 
在 这 种 情况 下 ， 可 以 使 用 新 的 清单 项 Adaa-Exports 和 Add-Opens。 这 两 个 选项 会 接收 由 一 个 
逗号 分 隔 的 S$ {module}/${package} 对 的 列表 ， 并 将 相应 的 包 针 对 类 路 径 中 的 代码 进行 导出 或 
公开 。 因 为 JVM 仅 在 应 用 程序 的 可 执行 JAR (通过 运行 时 的 -jar 选项 指定 的 JAR ) 中 扫描 这 些 
清音 项目， 所 以 没有 必要 将 它们 添加 到 库 函 数 JAR 中 。 

另 一 种 设置 永久 命令 行 选项 的 方式 是 借助 环境 变量 JDK_JAVA_OPTIONS ( 至 少 对 于 JVM 是 
这 样 的 )。 因 为 这 个 环境 变量 由 Java 9 及 以 上 版 本 引入 ， 所 以 Java 8 不 会 与 它 不 兼容 。 你 可 以 随 
意 添加 任何 针对 Java 9 及 以 上 版 本 的 命令 行 选 项 ， 每 次 在 机 器 上 执行 java 命令 时 都 要 使 用 这 些 
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项 。 这 个 方式 不 会 成 为 一 种 长 期 方案 ， 却 会 让 一 些 实验 变 得 更 容易 。 
最 后 ,命令 行 选 项 不 必 通 过 命令 行 直接 输入 .有 一 种 替代 方式 被 称 为 参数 文件 ( 或 者 @-files )， 
这 是 一 个 纯 文 本 文件 ,可 以 由 命令 行 通过 es{filename} 引 用 。 编 译 器 和 运行 时 会 将 文件 内 容 当 
作 命 令 行 参数 处 理 。 
7.2.4 节 展示 过 如 何 编译 使 用 了 JEE 和 JSR 305 注解 的 代码 。 
$ javac 

--add-modules java.xml .ws.annotation 

--patch-module java.xml .ws.annotation=jsr305-3.0.2.jar 

--class-path 'libs/*' 


-d classes/monitor.rest 
$s{source-files} 
























































在 这 里 , --add-modules 和 --patch-module 可 以 让 这 些 代 码 在 Java9 及 以 上 版 本 中 编译 
通过 。 你 可 以 将 这 两 行 放 到 一 个 叫 作 java-LATEST-args 的 文件 中 ， 并 用 下 面 的 命令 执行 编译 。 
$ javac 
@java-LATEST-args 
--class-path 'libs/*' 


-d classes/monitor.rest 
$s{source-files} 


Java 9 及 以 上 版 本 中 的 新 功能 之 一 是 JVM 可 以 识别 参数 文件 ， 因 此 人 们 可 以 在 编译 和 执行 
之 间 共 享 该 文件 。 





Maven 和 参数 文件 
很 遗憾 , 参数 文件 不 适用 于 Maven。 这 是 因为 编译 器 插件 已 经 为 它 的 所 有 选项 创建 了 对 应 
的 文件 ， 而 Java 不 支持 误 套 参数 文件 。 


2. 依赖 弱 封 装 

正如 7.1 节 详 细 说 明 的 那样 ， 默 认 情况 下 , 在 Java9 至 Java 11 (或 更 高 版 本 ) 的 运行 时 进行 
非法 访问 ， 仅 仅 会 引发 警告 。 这 对 于 运行 未 准备 好 的 应 用 程序 非常 有 用 ， 但 是 本 书 不 建议 在 真正 的 
构建 过 程 中 依赖 于 此 ， 因 为 它 会 引起 容易 被 忽视 的 新 非法 访问 。 相 反 ， 本 书 建议 在 添加 所 有 需要 的 
--add-exports 和 --add-opens 选项 后 , 在 运行 时 开启 强 封装 选项 . --illegal- access=deny。 


3. 命令 行 选项 中 的 陷阱 

在 使 用 命令 行 选项 时 ， 有 一 些 陷 阱 需要 避免。 

口 这 些 选项 在 某 种 意义 上 具有 传递 性 : 如 果 一 个 JAR 需要 它们 ， 那 么 它 所 有 的 依赖 项 也 需 
要 它们 。 

口 如 果 一 些 类 库 和 框架 需要 使 用 特殊 的 选项 ， 其 开发 人 员 往 往 会 在 文档 中 加 入 描述 ， 提 醒 
用 户 使 用 它们 ， 然 而 在 发 送 无 法 挽回 的 错误 之 前 ， 这 些 文档 往往 无 人 阅读 。 

口 应 用 程序 开发 人 员 必 须 维 护 一 个 选项 列表 ， 并 且 该 列表 包含 了 他 们 所 使 用 的 类 库 和 框架 
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对 选项 的 要 求 。 
口 在 不 同 构建 阶段 和 执行 之 间 以 共享 的 方式 来 维护 选项 并 不 是 一 件 容易 的 事情 。 
口 在 升级 到 兼容 Java 9 的 版 本 时 很 难 确定 可 以 删除 哪些 选项 。 
口 将 选项 应 用 于 正确 的 Java 进程 可 能 很 棘手 ， 例 如 ， 把 一 个 构建 工具 插件 应 用 于 不 在 同一 
个 进程 中 运行 的 构建 工具 。 
这 些 陷阱 清楚 地 表明 了 一 件 事 : 尽管 命令 行 选 项 是 一 种 解决 方案 , 但 它 不 是 最 好 的 , 并 且 使 
用 它 具 有 “长 期 成 本 ”"。 这 绝 非 偶然 一 一 它们 则 在 使 不 太 可 能 的 事情 成 为 可 能 。 但是， 这 并 不 容 
易 ， 否 则 人 们 不 会 有 动力 去 解决 根本 问题 。 
所 以 尽 最 大 的 努力 , 仅 依 赖 于 公有 的 和 受 支 持 的 API， 不 要 造成 包 分 裂 ， 并且 尽量 避免 本 章 
提 到 的 麻烦 。 更 重要 的 是 ， 如 果 有 类 库 和 框架 也 能 做 到 这 些 ， 就 奖励 它们 吧 ! 但 是 , 好心 办 坏事 
的 现象 时 有 发 生 ， 因 此 ， 如 果 所 有 其 他 操作 都 失败 ， 请 使 用 所 有 可 用 的 命令 行 标志 。 


9.2 ”模块 化 策略 
在 第 8 章 中 ,你 学 习 了 所 有 有 关 无 名 模块 、 自 动 模块 ， 以 及 混合 普通 JAR、 模 块 化 JAR、 类 


路 径 和 模块 路 径 的 知识 。 但 是 , 如 何 将 其 付 诸 实 践 呢 ? 增 量 模 块 化 代码 库 的 最 佳 策 略 是 什么 ? 要 
回答 这 些 问题 ， 请 先 将 整个 Java 生态 系统 想象 成 一 个 巨大 的 工件 分 层 图 ( 如 图 9-1 所 示 )。 
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图 9-1 对 Java 生态 系统 的 全 局 依赖 关系 图 的 艺术 性 解释 : 最 底层 是 Java.base 和 JDK 
的 其 余部 分 ,它们 之 上 是 没有 第 三 方 依赖 的 类 库 ， 再 往 上 是 更 复杂 的 类 库 和 框 
架 ， 最 顶层 是 应 用 程序 ( 请 不 要 过 于 关注 图 中 任何 单独 的 依赖 项 ) 















































图 的 最 底层 是 JDK, 这 里 曾经 只 是 一 个 独立 的 节点 , 但 是 在 模块 系统 诞生 后 ,现在 这 层 由 以 
java.base 为 基础 的 约 100 个 节点 组 成 。 它们 之 上 是 除 JDK 之 外 没有 运行 时 依赖 的 那些 类 库 ( 例如 
SLF4J、Vavr 和 AssertJ )， 再 往 上 是 只 有 少量 依赖 的 类 库 (例如 Guava、JOOQ 和 JUnit5 )- 图 的 
中 间 部 分 是 层级 更 深 的 框架 ( 例如 Spring 和 Hibernate )。 图 的 最 顶层 是 应 用 程序 。 
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除 JDK 之 外 ， 在 Java 9 出 现时 ， 这 些 工件 都 是 普通 的 JAR， 并 且 其 中 的 大 多 数 需要 几 年 时 
间 才 能 添加 模块 描述 符 。 但 这 是 如 何 实现 的 ? 生态 系统 如 何在 不 分 型 的 情况 下 经 历 如 此 巨大 的 变 
化 ? 解决 方案 是 通过 无 名 模块 (参见 8.2 节 ) 和 自动 模块 (参见 8.3 节 ) 启用 的 模块 化 策略 。 它 
们 使 Java 社区 几乎 可 以 彼此 独立 地 将 生态 系统 模块 化 。 

对 于 开发 者 来 说 ， 最 容易 维护 的 项 目 除 JDK 之 外 没有 其 他 任何 依赖 关系 ， 也 可 能 其 依赖 已 
得 到 模块 化 ， 因 为 这 样 可 以 实施 自 下 而 上 的 策略 (参见 9.2.1 节 )。 对 于 应 用 程序 ， 自 上 而 下 的 方 
法 (参见 9.2.2 节 ) 也 提供 了 一 种 演进 途径 。 对 于 类 库 和 框架 的 维护 人 员 而 言 ， 维 护 未 模块 化 的 
依赖 关系 会 更 加 困难 ， 并 且 需 要 由 内 而 外 地 进行 操作 (参见 9.2.3 区 。 

如 果 把 生态 系统 看 成 一 个 整体 ,那么 项 目 在 其 中 的 位 置 决定 了 你 必须 使 用 的 策略 。 图 9-2 将 
帮 你 选择 正确 的 答案 。 但 正如 9.2.4 节 所 述 ， 这 些 方法 也 在 各 个 独立 项 目的 内 部 适用 。 在 这 种 情 
况 下 ,你 可 以 选择 这 三 种 方法 中 的 任何 一 种 。 但 是 在 做 出 选择 之 前 ， 先 假设 你 准备 一 次 性 模块 化 
所 有 工件 ， 这 样 学 习 这 些 策略 会 更 加 容易 。 












































le 
(参见 9.2.1 节 ) 
由 内 而 外 
(参见 9.2.3 节 ) 
自 上 而 下 
(参见 9.2.2 节 ) 





图 9-2 ”如 何 确定 适合 项 目的 模块 化 策略 


只 要 JAR 中 包含 模块 描述 符 ， 你 就 可 以 宣传 该 项 目 已 经 可 以 在 Java 9 及 以 上 版 本 中 作为 
模块 使 用 。 但 是 只 有 在 已 经 采取 了 所 有 可 能 的 步 又， 确保 它 能 够 顺利 运行 时 ， 你 才 应 该 这 样 
做 。 第 6 章 和 第 7 章 介绍 了 与 此 相关 的 大 多 数 挑战 , 但 是 如 果 代 码 使 用 了 反射 , 你 还 应 该 阅读 
第 12 章 。 

如 果 用 户 必须 做 某 些 事 才能 使 模块 正常 工作 ( 比如 在 他 们 的 应 用 程序 中 添加 命令 行 标志 )， 
你 应 该 对 此 进行 详细 的 文档 描述 。 请 注意 , 你 可 以 创建 能 在 Java 8 和 更 早 版 本 中 无 缝 运行 的 模块 
化 JAR，9.3.4 节 将 介绍 该 内 容 。 

正如 本 书 经 常 提 到 的 , 模块 具有 3 个 基本 属性 : 名 称 、 清 晰 定义 的 API 和 明确 的 依赖 。 在 创 
建 模 块 时 ,显然 必须 为 其 命名 。 尺 管 人 们 可 能 会 对 导出 吹 毛 求 辛 , 但 是 大 多 数 情况 下 它 是 根据 需 
要 访问 的 类 预先 确定 的 。 真正 的 挑战 ,以 及 生态 系统 的 其 余部 分 发 挥 作用 的 地 方 就 是 依赖 。 本 节 
将 重点 介绍 这 一 方面 。 
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了 解 你 的 依赖 

你 必须 相当 了 解 直 接 和 间接 依赖 关系 才能 成 功 地 将 项 目 模块 化 。 请 记 住 ,你 可 以 使 用 JDeps 
来 确定 依赖 关系 (尤其 是 平台 模块 ， 参 见 附 录 D )， 还 可 以 使 用 jar --describe-module 来 
检查 JAR 的 模块 化 状态 (参见 4.5.2 节 和 8.3.1 欧 。 





了 解 了 以 上 内 容 后 ， 现 在 该 看 看 这 3 种 模块 化 策略 是 如 何 工作 的 了 。 


9.2.1 自 下 而 上 的 模块 化 : 如 果 项 目的 所 有 依赖 都 已 模块 化 


将 项 目的 JAR 转换 为 模块 的 最 简单 情况 是 假设 代码 仅 ( 直接 地 和 间接 地 ) 依赖 于 清晰 模块 。 
不 管 是 平台 模块 还 是 应 用 程序 模块 都 没有 关系 ， 你 可 以 直接 开始 。 

(1) 创建 模块 声明 ， 其 中 包含 所 有 需要 的 直接 依赖 。 

(2) 将 含有 非 JDK 依赖 的 JAR 放 在 模块 路 径 上 。 

现在 你 的 项 目 已 经 得 到 了 完全 的 模块 化 一 一 蕉 喜 ! 如 果 你 正在 维护 一 个 类 库 或 是 框架 , 而 用 
户 将 你 的 JAR 放置 在 了 模块 路 径 上 ， 那 么 它们 将 成 为 清晰 模块 ， 用 户 可 以 从 模块 系统 中 受益 。 
自 下 而 上 的 模块 化 示例 如 图 9-3 所 示 。 

















只 模块 化 那些 仅 依赖 
于 模块 的 JAR 





























图 9-3 ”依赖 于 模块 化 JAR 的 工件 可 以 立即 进行 模块 化 ， 进 而 导致 自 下 而 上 的 迁移 


几乎 同样 重要 但 不 那么 明显 的 是 , 由 于 类 路 径 上 的 所 有 JAR 最 终 都 成 了 无 名 模块 (参见 82 节 )， 
此 没有 人 被 迫 将 其 作为 模块 使 用 。 如 果 坚 持 使 用 类 路 径 , 那么 项 目 会 正常 运行 ,仿佛 其 中 的 模 
块 描述 符 不 存在 一 样 。 如 果 你 想 对 类 库 进 行 模块 化 ， 但 它 的 依赖 还 不 是 模块 ， 请 参阅 9.2.3 节 。 


9.2.2 ” 自 上 而 下 的 模块 化 : 如 果 应 用 程序 无 法 等 待 其 依赖 


如 果 应 用 程序 开发 人 员 和 希望 尽快 进行 模块 化 , 那么 项 目的 所 有 依赖 不 太 可 能 都 已 经 发 布 了 模 
块 化 JAR。 如 果 它 们 真 的 都 已 经 发 布 了 模块 化 JAR, 那么 很 幸运 ,你 可 以 采用 前 文 描述 的 自 下 而 
上 的 方法 ; 否则 ， 你 必须 使 用 自动 模块 ， 并 着 手 混合 模块 路 径 和 类 路 径 。 

(1) 创建 模块 声明 ， 其 中 包含 所 有 需要 的 直接 依赖 。 

(2) 将 所 有 模块 化 JAR ( 包括 你 构建 的 和 所 有 依赖 ) 放 在 模块 路 径 上 。 
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(3) 将 所 有 被 模块 化 JAR 直接 依赖 的 普通 JAR 放 在 模块 路 径 上 ， 它 们 将 被 转换 为 自动 模块 。 

(4) 思考 如 何 处 理 其 余 的 普通 JAR (参见 8.3.3 蒋 。 

最 简单 的 方法 可 能 是 将 其 余 所 有 JAR 放 在 构建 工具 或 IDE 中 的 模块 路 径 上 并 尝试 让 其 工 
作 。 尽 管 本 书 通常 认为 这 不 是 最 好 的 方法 ， 但 它 可 能 对 你 有 用 。 如 果 确 实 是 这 样 ， 那 就 采用 这 
种 方法 吧 。 

如 果 遇 到 包 分 裂 或 者 访问 JDK 内 部 API 的 问题 ， 你 可 以 尝试 将 这 些 JAR 放 在 类 路 径 上 。 
为 只 有 自动 模块 才 需 要 它们 ， 而 且 它 们 可 以 读 取 无 名 模块 ， 所 以 可 以 正常 工作 。 

将 来 , 一 旦 一 个 之 前 的 自动 模块 被 模块 化 , 该 设置 可 能 会 失败 。 因 为 现在 该 模块 是 位 于 模块 
路 径 上 的 模块 化 JAR， 因 此 无 法 从 类 路 径 访 问 其 代码 。 我 认为 这 是 一 件 好 事 ， 因 为 通过 它 可 以 更 
好 地 了 人 解 哪 些 依赖 是 模块 ， 哪 些 依赖 不 是 模块 一 一 这 也 是 检查 其 模块 描述 符 并 了 解 项 目的 好 机 
会 。 要 解决 此 问题 ， 请 将 模块 的 依赖 移 至 模块 路 径 。 自 上 而 下 的 模块 化 示例 如 图 9-4 所 示 。 









































从 顶部 开始 ， 将 依赖 转换 为 自 
动 模块 











图 9-4 通过 自动 模块 , 可 以 对 依赖 于 普通 JAR 的 工件 进行 模块 化 。 应 用 程序 可 以 使 用 
这 种 方式 进行 自 上 而 下 的 模块 化 


























注意 ,不 必 担 心 自 动 模块 名 称 的 来 源 (参见 8.3.4 节 )。 的确 ， 如 果 它 们 基于 文件 名 ， 那 么 一 
旦 它们 获得 了 明确 的 模块 名 称 , 你 就 必须 更 改 一 些 requires 指令 。 但 是 由 于 你 可 以 控制 所 有 的 
模块 声明 ， 因 此 这 没什么 大 不 了 的 。 

那么 如 何 确保 非 模 块 化 依赖 项 需要 的 模块 正确 地 进入 模块 图 呢 ?” 应 用 程序 可 以 在 模块 声明 
中 添加 它们 ， 也 可 以 使 用 --adada-modqules 在 编译 时 和 启动 时 手动 添加 。 后 者 仅 当 你 对 启动 命令 
有 控制 权时 才 是 一 个 选项 ,构建 工具 也 许 能 够 帮 你 做 出 决定 , 但 是 你 仍然 需要 了 解 这 些 选 项 以 及 
如 何 进行 配置 ， 方 便 在 出 现 问题 时 加 以 解决 。 

















9.2.3 由 内 而 外 的 模块 化 : 如 果 项 目 位 于 中 间 层 级 


大 多 数 类 库 和 ( 尤其 是 ) 框架 既 不 在 软件 栈 的 底部 也 不 在 其 顶部 , 这 该 怎么 办 ?答案 是 由 内 
而 外 地 模块 化 。 这 个 过 程 有 些 自 下 而 上 (参见 9.2.1 节 ) 的 部 分 ， 因 为 发 布 模块 化 JAR 并 不 意味 
着 强迫 用 户 将 其 用 作 模 块 。 除 此 之 外 ， 其 工作 原理 类 似 于 自 上 而 下 (参见 9.2.2 节 ) 的 方法 ,但 
有 一 个 重要 区 别 : 你 计划 发 布 所 构建 的 模块 化 JAR。 由 内 而 外 模块 化 的 示例 如 图 9-5 所 示 。 
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从 图 中 的 任意 位 置 开 始 ， CE 
将 依赖 转换 为 自动 模块 从 该 处 开始 ， 结 合 自 下 而 
上 和 上 自 上 而 下 的 方法 





| 一 -- 疼 ， 
模块 化 . 

















图 9-5 如果 谨慎 地 使 用 自动 模块 ， 那 么 层级 中 间 的 类 库 和 框架 可 以 发 布 模块 化 的 JAR， 
即使 它们 的 依赖 及 其 用 户 可 能 仍然 停留 在 普通 的 JAR， 也 是 如 此 , 用 这 样 的 方式 
可 以 对 生态 系统 进行 由 内 而 外 的 模块 化 


正如 83.4 节 详细 讨论 的 那样 ,你 应 该 只 在 那些 普通 的 JAR 在 manifest 文 件 中 定义 了 Automatic- 
Module-Name 条 目 时 ,发 布依 赖 于 自动 模块 的 模块 ,否则 当 模 块 名 称 更 改 时 , 很 容易 引起 问题 。 

这 可 能 意味 着 项 目 尚 不 能 模块 化 。 如 果 遇 到 这 种 情况 ， 请 注意 选择 正确 的 处 理 方式 ,否则 可 
能 会 给 用 户 带 来 麻烦 。 

本 书 还 要 进一步 曾 明 : 检查 你 的 直接 和 间接 依赖 关系 ， 并 确保 没有 对 名 称 源 自 JAR 文件 名 
的 自动 模块 进行 依赖 。 你 需要 寻找 不 是 模块 化 JAR， 并 且 没有 定义 Automatic-Module-Name 
条 目的 依赖 。 我 不 会 发 布 能 够 引入 任何 此 类 JAR 的 模块 描述 符 的 工件 ， 无 论 自 己 的 依赖 还 是 他 
人 的 依赖 都 是 如 此 。 

当 涉及 你 的 非 模块 依赖 项 需要 而 你 本 身 不 需要 的 平台 模块 时 , 这 里 也 存在 一 些 细微 差异 。 应 
用 程序 可 以 轻松 使 用 命令 行 选 项 ,类 库 或 框架 则 不 能 ,它们 只 能 为 用 户 提供 说 明文 档 , 但 是 某 些 
用 户 一 定 会 忽略 这 些 文 档 。 因 此 ， 本 书 建议 明确 引用 非 模 块 化 依赖 项 需要 的 所 有 平台 模块 。 


9.2.4 在 项 目 中 应 用 这 些 策略 


具体 使 用 三 种 策略 中 的 哪 一 种 ， 取 决 于 你 的 项 目 在 整个 生态 系统 的 巨大 依赖 关系 图 中 的 位 
置 。 但 是 ,如果 一 个 项 目 过 大 ,无 法 立即 全 部 模块 化 ,你 可 能 想 知道 如 何 逐 步 将 其 模块 化 。 好 消 
息 是 : 你 可 以 较 小 规模 地 应 用 类 似 的 策略 。 

通常 , 将 自 下 而 上 的 策略 应 用 于 项 目 是 最 容易 的 , 首先 模块 化 仪 依赖 于 你 代码 库 之 外 的 代码 
的 子 项 目 。 如 果 你 的 依赖 项 均 已 被 模块 化 ， 此 方法 将 特别 有 用 , 但 也 不 仅 限于 这 种 情况 ; 如 果 你 
的 依赖 项 没有 被 模块 化 , 则 需要 将 自 上 而 下 的 逻辑 应 用 于 子 项 目的 最 低层 级 ,让 它们 使 用 自动 模 
块 来 依赖 于 普通 的 JAR， 然 后 从 该 处 开始 构建 。 

自 上 而 下 的 方法 在 应 用 于 单个 项 目 时 , 其 工作 原理 与 应 用 于 整个 生态 系统 时 相同 : 在 图 的 项 
部 对 工件 进行 模块 化 ,将 其 放置 在 模块 路 径 上 ,并 将 它 的 依赖 项 转换 为 自动 模块 ,之 后 慢 慢 地 对 
整个 依赖 树 执行 同样 的 动作 。 

你 甚至 可 以 由 内 而 外 地 进行 模块 化 。 第 10 章 将 介绍 “服务 ”一 种 使 用 模块 系统 分 离 项 目 内 
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部 以 及 不 同 项 目 之 间 依 赖 关 系 的 好 方法 。 这 是 从 项 目的 依赖 关系 图 中 间 的 某 处 开始 模块 化 , 并 从 
那里 向 上 或 向 下 移动 的 好 理由 。 


要 点 ”请 注意 ， 无 论 在 内 部 选择 哪 种 方法 ， 你 都 不 能 发 布依 赖 于 自动 模块 的 清晰 
模块 ， 因 为 这 些 自动 模块 的 名 称 不 是 由 JAR 文 件 名 定义 的 ,而 应 与 Automatic- 
Module-Name 的 manifest 条目 相 对 。 


尽管 可 能 性 很 多 , 但 你 不 需要 将 事情 复杂 化 。 确定 了 方法 之 后 , 请 尝试 快速 而 有 条 理 地 对 项 
目 进行 模块 化 。 根据 该 过 程 制定 策略 并 尝试 在 各 处 创建 模块 , 意味 着 你 理解 项 目 依赖 关系 图 将 比 
较 艰 难 。 这 与 模块 系统 的 重要 目标 之 一 一 一 可 靠 配置 一 一 也 是 相对 立 的 。 


9.3 ”将 JAR 模块 化 


将 普通 JAR 转换 为 模块 化 JAR 所 要 做 的 就 是 向 其 源 文件 中 添加 模块 声明 。 容 易 吧 ? 是 的 ， 
但 是 需要 注意 的 具体 步 又 不 止 下 面 这 几 点 。 
口 你 可 能 要 考虑 创建 开放 式 模块 ( 对 此 的 简单 介绍 参见 9.3.1 欧 。 
口 创建 数 十 个 甚至 数 百 个 模块 声明 可 能 会 让 人 和 手忙脚乱， 你 希望 有 一 种 工具 可 以 为 你 做 这 
件 事 (参见 9.3.2 圾 。 
口 你 需要 进行 模块 化 的 JAR 可 能 不 是 自己 构建 的 ; 或 者 依赖 项 可 能 破坏 了 其 模块 描述 符 ， 
而 你 需要 对 其 进行 修复 (参见 9.3.3 欧 。 
口 你 可 能 想 了 解 JAR 中 为 Java 8 或 更 早 版 本 构建 的 模块 描述 符 。 这 有 可 能 吗 (参见 9.3.4 节 ) ? 
本 节 讨 论 了 这 些 主题 ， 绝 对 值得 你 花 时 间 阅 读 。 


9.3.1 ”作为 中 间 步 又 的 开放 式 模块 


在 应 用 程序 的 增 量 模块 化 期 间 ， 一 个 很 有 用 的 概念 是 开放 式 模块 。12.2.4 节 将 对 此 进行 详细 
介绍 , 但 核心 是 开放 模块 不 再 遵守 强 封装 规则 : 模块 中 的 所 有 包 都 被 导出 并 开放 以 支持 反射 ， 这 
意味 着 在 编译 期 间 , 人 们 可 以 访问 其 所 有 公有 类 型 ,并 且 可 以 通过 反射 访问 所 有 其 他 类 型 和 成 员 。 
可 以 在 模块 声明 中 使 用 open module 并 创建 它 。 

当 你 对 JAR 的 包 布 局 不 满意 时 ， 开 放 式 模块 可 以 派 上 用 场 。 你 也 许 不 希望 访问 某 些 包 或 者 
许多 包 中 的 公有 类 型 ， 因 为 在 这 两 种 情况 下 ， 重 构 可 能 会 花费 太 多 时 间 。 或 者 ,在 该 模块 中 ,， 反 
被 大 量 地 使 用 ， 而 你 不 想 逐 个 确定 所 有 需要 开放 的 包 。 

在 这 种 情况 下 , 开放 整个 模块 是 将 这 些 问题 延迟 到 未 来 的 好 方法 。 关 于 偿还 技术 债 的 注意 事 
项 一 一 这 些 模块 不 选择 使 用 强 封装 ， 使 得 它们 无 法 获得 随 之 而 来 的 好 处 。 

要 点 ”因为 将 一 个 开放 式 模 块 转换 为 常规 的 、 封 装 的 模块 是 一 种 不 兼容 的 更 改 ， 

所 以 类 库 和 框架 在 开始 时 永远 不 要 采用 开放 式 模 块 ( 因为 目标 是 稍 后 将 其 关闭 )。 

很 难 想 象 这 样 的 项 目 发 布 一 个 开放 式 模块 的 理由 。 最 好 只 在 应 用 程序 中 使 用 它 。 
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9.3.2 ”使 用 JDeps 生成 模块 声明 

















如 果 你 有 一 个 大 项 目 ,可 能 需要 创建 几 十 个 其 至 数 百 个 模块 声明 , 这 是 一 项 艰巨 的 任务 。 幸 
好 ， 大 部 分 工作 可 以 使 用 JDeps 完成 ， 因 为 这 些 工 作 是 机 械 性 的 。 


口 模块 名 称 通常 可 以 从 JAR 名 称 推断 。 





























口 可 以 通过 跨 JAR 边界 扫描 字 节 码 来 分 析 项 目的 依赖 关系 。 
口 导出 与 此 分 析 相 反 ， 这 意味 着 其 他 JAR 依赖 的 所 有 包 都 需要 导出 。 


除了 这 些 基本 属性 ,还 可 能 需要 进行 一 些微 调 ， 以 确保 所 有 的 依赖 关系 都 能 被 记录 ; 同时 保 
证 服务 ( 参见 第 10 章 ) 或 更 详细 的 依赖 和 API ( 参见 第 11 章 ) 能 够 正确 地 配置 和 使 用 。 但 到 目 








前 为 止 ， 所 有 内 容 都 可 以 由 JDeps 生成 。 








使 用 --generate-module-info $s{target-dir} ${jar-dir} 选 项 ， JDeps 会 分 析 $ {jar-dir} 
中 的 所 有 JAR， 并 为 S${target-dir}/${module-name} 中 的 每 个 JAR 生成 module-info.java 


文件 。 


头 ， 参见 8.3.1 欧 。 




















字 标 记 (参见 11.1 次 。 





口 依赖 关系 是 基于 JDeps 的 依赖 性 分 析 派 生出 来 的 ， 公 开 的 依赖 关系 用 transitive 关键 


口 模块 名 来 自 于 JAR 文件 名 ， 就 像 自动 模块 的 文件 名 一 样 (包括 Automatic-Module-Name 





口 通过 分 析 ， 包 含 其 他 JAR 所 依赖 类 型 的 包 被 导出 。 


当 JDeps 生成 module-info.java 文件 时 ， 由 你 来 检查 并 调整 它们 ， 并 将 它们 移 至 正确 的 源 代 











码 目录 中 ， 以 便 下 一 个 构建 可 以 编译 和 打包 。 














再 次 假设 ServiceMonitor 还 未 模块 化 ， 你 可 以 使 用 JDeps 生成 模块 声明 。 为 此 ， 你 构建 了 
ServiceMonitor 应 用 程序 , 并 将 它 的 JAR 和 依赖 放 在 了 jars 目录 中 。 然 后 调用 jdeps --generate- 
module-info declarations jars， 生 成 模块 声明 ， 并 将 其 写 和 如 图 9-6 所 示 的 目录 结构 中 。 


declarations 
国 monitor 
目 modu 





品 


modu 





modu 





modu 





modu 





modu 











夯 男 芳 厂 面 
333U3U330 


modu 




















e-info.j 
onitor.observer 


e-info. 


e-info. 


e-info.j 


e-info.j 
onitor.rest 
e-info.j 
onitor. statistics 


e-info. 











ava 


java 


onitor.observer.alpha 


java 


onitor.observer.beta 


ava 


onitor.persistence 


ava 


ava 





java 


图 9-6 调用 jdeps --generate-module-info declarations jars 之 后 ，JDeps 
分 析 jars 目录 中 所 有 JAR 之 间 的 依赖 关系 (未 显示 )， 并 在 declarations 目录 中 
创建 模块 声明 ( 非 ServiceMonitor 项 目的 模块 声明 未 显示 ) 
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JDeps 会 为 每 个 模块 创建 一 个 目录 ， 并 在 其 中 放置 与 前 面 手动 编写 的 模块 声明 类 似 的 模块 声 
明 〈 可 以 在 代码 清单 2-2 中 找到 它们 ， 但 是 这 里 细节 并 不 重要 )。 

JDeps 还 可 以 使 用 --generate-open-module 选项 为 开放 式 模块 生成 模块 声明 (参见 12.2.4 
节 )。 模 块 名 称 和 requires 指令 的 确定 方法 像 以 前 一 样 ， 但 是 ， 由 于 开放 式 模块 不 能 封装 任何 
东西 ， 所 以 不 需要 导出 ， 因 而 不 会 生成 任何 模块 声明 。 


1. 检查 生成 的 声明 

尽管 JDeps 在 自动 生成 模块 声明 方面 做 得 很 好 , 但 你 仍然 应 该 手动 检查 它们 。 你 喜欢 模块 名 
称 吗 (可 能 不 喜欢 ， 因 为 JAR 名 称 很 少 遵循 反 域 命名 的 方案 ,参见 3.1.3 节 ) ? 依赖 关系 构建 是 
否 正确 ( 更 多 选项 参见 11.1 节 和 11.2 节 ) ? 你 希望 的 共有 API 是 否 得 到 了 正确 导出 ?也 许 你 需 
要 添加 一 些 服务 (参见 第 10 况 。 
如 果 你 开发 的 应 用 程序 中 有 太 多 的 JAR 文件 ， 无 法 手动 检查 所 有 声明 ， 而 你 不 介意 一 些 磷 
兢 绊 绊 , 那么 还 有 一 个 更 好 的 选择 : 信任 测试 、 持 续集 成 流程 ， 并 相信 开发 人 员 和 测试 人 员 能 够 
发 现 这 些小 问题 。 在 这 种 情况 下 , 请 在 下 一 个 版 本 发 布 之 前 留 有 一 些 时 间 ， 以 便 确认 所 有 问题 已 
经 修复 。 

但 是 ， 如 果 打 算 发 布 工件 ， 那么 你 必须 非常 小 心地 检查 声明 ! 这 些 是 公开 的 API， 通常 对 它 
们 的 更 改 是 不 兼容 的 一 一 如 果 没 有 充分 的 理由 ， 请 尽量 防止 这 种 情况 发 生 。 


2. 当心 依赖 丢失 
为 了 让 JDeps 正确 地 生成 JAR 的 requires 指令 ， 所 有 的 JAR 及 其 直接 依赖 必须 位 于 扫描 
目录 中 。 如 果 缺 少 依 赖 项 ，JDeps 会 报告 如 下 错误 。 

















































































































> Missing dependence: .../module-info.java not generated 
> Error: missing dependencies 
> depending.type -> missing.type not found 


> 


为 了 避免 后 成 错误 的 模块 声明 ， 在 缺少 依赖 的 模块 中 不 会 生成 任何 模块 声明 。 
为 ServiceMonitor 生成 模块 声明 时 , 我 忽略 了 这 些 消息 。Maven 认为 一 些 间接 依赖 是 可 选 的 ， 
这 造成 了 它们 的 缺失 ,但 并 不 妨碍 正确 生成 ServiceMonitor 的 模块 声明 。 


> Missing dependence: 

> declarations/jetty.servlet/module-info.java not generated 
省 略 了 更 多 的 日 志 信 息 

> Missing dependence: 

> declarations/utils/module-info.java not generated 

省 略 了 更 多 的 日 志 信息 

> Missing dependence: 

> declarations/jetty.server/module-info.java not generated 
省 略 了 更 多 的 日 志 信息 

> Missing dependence: 

> declarations/slf4j.api/module-info.java not generated 
省 略 了 更 多 的 日 志 信息 


> Error: missing dependencies 





























188 第 9 章 迁移 和 模块 化 策略 
































> org.eclipse.jetty.servlet.jmx.FilterMappingMBean 

> -> org.eclipse.jetty.jmx.ObjectMBean not found 
泥 org.eclipse.jetty.servlet.jmx.HolderMBean 

> -> org.eclipse.jetty.jmx.ObjectMBean not found 
SS org.eclipse.jetty.servlet.jmx.ServletMappingMBean 

> -> org.eclipse.jetty.jmx.ObjectMBean not found 
SS org.eclipse.jetty.server.handler.jmx.AbstractHandlerMBean 

> -> org.eclipse.jetty.jmx.ObjectMBean not found 
> org.eclipse.jetty.server.jmx.AbstractConnectorMBean 

Ss -> org.eclipse.jetty.jmx.ObjectMBean not found 
2 org.eclipse.jetty.server.jmx.ServerMBean 

> -> org.eclipse.jetty.jmx.ObjectMBean not found 
> org.slf4j .LoggerFactory 

> -> org.slf4j.impl.StaticLoggerBinder not found 
> org.slf4j .MDC 

S -> org.slf4j.impl.StaticMDCBinder not found 
> org.slf4j .MarkerFactory 

> -> org.slf4j.impl.StaticMarkerBinder not found 





3. 仔细 地 分 析 导 出 

导出 指令 完全 基于 对 其 他 JAR 需要 哪些 类 型 的 分 析 ， 这 将 导致 类 库 JAR 被 导出 的 包 较 少 。 
在 检查 JDeps 输出 时 ， 请 记 住 这 一 点 。 

类 库 或 框架 的 开发 人 员 可 能 不 愿意 只 因为 几 个 模块 需要 就 发 布 只 在 项 目 内 使 用 的 工件 。 参 见 
11.3 节 中 的 合 规 导出 来 解决 这 个 问题 。 

















9.3.3 ”黑客 破译 第 三 方 JAR 


有 时 ， 人 们 需要 更 新 第 三 方 JAR。 人 们 可 能 需要 一 个 清晰 模块 , 或 者 至 少 具有 特定 名 称 的 自 
动 模块 ; 也 许 它 已 经 是 一 个 模块 , 但 是 模块 描述 符 有 错误 , 或 者 引入 了 人 们 不 希望 使 用 的 错误 依 
赖 。 在 这 种 情况 下 ， 可 以 采用 一 些 趁 手 的 工具 ( 注意 不 要 伤 到 自己 )。 

像 Java 这 样 的 大 型 生态 系统 中 必然 存在 一 些 边缘 情况 ， 字 节 码 操作 工具 Byte Buddy 就 是 一 
个 很 好 的 例子 。 它 在 Maven Central 中 以 pyte-puddy-${version} .ja 的 形式 发 布 。 当 你 尝 
试 将 它 用 作 自 动 模块 时 ,会 从 模块 系统 中 得 到 如 下 提示 。 


> byte.buddy: Invalid module name: 'byte' is not a Java identifier 


糟糕 ，byte 不 是 有 效 的 Java 标识 符 ， 因 为 它 与 基本 类 型 的 名 称 相 冲 突 。 这 种 特殊 情况 在 
Byte Buddy 的 1.7.3 版 或 更 高 版 本 中 得 到 了 解决 (使 用 Automatic-Module-Name ), 但 是 你 可 
能 会 遇 到 类 似 的 边缘 情况 ， 因 此 需要 做 好 准备 。 

一 般 来 说 ， 对 已 发 布 的 JAR 进行 本 地 修改 是 不 可 取 的 ， 因 为 要 以 可 靠 并 且 自 描述 的 方式 进 
行 修 改 非常 困难 。 如 果 你 的 开发 过 程 中 包含 本 地 工件 公共 仓库 ， 比 如 所 有 开发 人 员 都 能 连接 的 
Sonatype 的 Nexus， 那 么 事情 就 会 变 得 简单 一 些 。 在 这 种 情况 下 ， 可 以 创建 一 个 修改 后 的 变 体 ， 
通过 更 新 版 本 使 得 修改 更 加 明显 (例如 添加 -patch )， 然 后 将 其 上 传 到 内 部 公共 仓库 。 

你 也 可 以 在 构建 过 程 中 进行 修改 。 在 这 种 情况 下 ,可 以 根据 需要 动态 地 使 用 和 编辑 标准 JAR。 
这 样 ， 修 改 会 成 为 构建 脚本 的 一 部 分 。 
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注意 ， 永 远 不 要 发 布依 赖 于 已 修改 JAR 的 工件 ， 因 为 用 户 无 法 轻松 地 进行 相同 的 修改 ， 他 
们 只 能 面 对 一 个 无 法 工作 的 依赖 。 这 使 得 以 下 将 要 介绍 的 建议 仅 适用 于 应 用 程序 。 

有 了 这 些 注意 事项 ， 下 面 看 看 如 果 第 三 方 JAR 不 能 满足 你 的 项 目 需求 ， 如 何 对 其 进行 修改 
适 配 。 我 将 向 你 展示 如 何 添加 和 编辑 自动 模块 名 称 、 添 加 和 编辑 模块 描述 符 以 及 向 模块 中 添加 类 。 


1. 添加 和 编辑 自动 模块 名 称 

向 JAR 中 添加 自动 模块 名 称 的 一 个 很 好 的 理由 是 ， 如 果 项 目 已 经 在 较 新 的 版 本 中 定义 了 一 
个 模块 名 称 ， 但 是 由 于 某 种 原因 ， 你 还 不 能 对 其 进行 更 新 ， 那 么 可 以 将 该 模块 名 称 添 加 到 JAR 
中 ,而 不 是 采用 JPMS 推断 的 名 称 。 在 这 种 情况 下 , 编辑 JAR 允许 你 在 模块 声明 中 使 用 未 来 不 会 
过 时 的 名 称 。 

jar 工具 中 有 --update( 即 -u ) 选项 ， 它 使 人 们 能 修改 现 有 的 Java 归档 。 将 其 与 
--manifest=${manifest-file}) 选 项 结合 在 一 起 ， 你 可 以 将 任何 内 容 附 加 到 现 有 的 manifest 
中 ， 例 如 Automatic-Module-Name 条 目 。 

以 Byte Buddy 的 旧版 本 1.6.5 为 例 ， 确 保 它 作为 一 个 上 自动 模块 可 以 正常 工作 。 首 先 ， 创建 一 
个 纯 文本 文件 ， 比 如 manifest.txt( 你 可 以 选择 任何 想 要 的 名 称 )， 其 只 包含 一 行 代码 。 

Automatic-Module-Name: net.bytebuddy 

然后 ,使 用 jar 将 这 一 行 代码 追加 到 现 有 的 manifest 文件 中 。 


$ jar --update --file byte-buddy-1.6.5.jar --manifest=manifest.txt 
现在 看 看 是 否 有 效 。 


$ jar --describe-module --file byte-buddy-1.6.5.jar 

























































































> No module descriptor found. Derived automatic module. 
~ 

> net.bytebuddy@1.6.5 automatic 

> requires java.base mandated 


结果 非常 整洁 : 没有 错误 ， 并 且 模 块 名称 与 预期 一 致 。 
可 以 使 用 相同 的 方法 编辑 现 有 的 自动 模块 名 称 。 尽 管 jar 工具 会 抱怨 Duplicate name in 
Manifest ( Manifest 中 的 名 称 重复 )， 但 是 新 值 仍然 会 蔡 换 旧 值 。 


2. 添加 和 编辑 模块 描述 符 

如 果 仅 将 第 三 方 JAR 转换 为 正确 命名 的 自动 模块 还 不 够 ， 或 者 清晰 模块 有 问题 ， 那 么 可 以 
使 用 jar --update 添加 或 覆盖 模块 描述 符 。 后 者 的 一 个 重要 用 例 是 解决 8.3.4 节 描 述 的 模块 的 
死亡 之 眼 。 


$ jar --update --file ${jar} module-info.class 


这 会 把 module-info.class 文件 添加 到 $ {jar} 中 。 注 意 ，--update 不 执行 任何 检查 ， 因 此 容 
易 出 现 模块 描述 符 和 类 文件 不 一 致 的 JAR (这 可 能 是 故意 的 ， 也 可 能 是 意外 )， 例 如 两 者 需要 的 
依赖 不 一 致 。 因 此 ， 请 小 心 使 用 ! 
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更 复杂 的 任务 是 创建 模块 描述 符 。 为 了 让 编译 器 创建 一 个 模块 描述 符 , 你 不 仅 需要 一 个 模块 
声明 ， 还 需要 所 有 依赖 ( 对 此 的 检查 可 以 作为 可 靠 配置 的 一 部 分 ) 和 JAR 的 代码 〈 作为 源 代码 
或 字 节 码 ， 否 则 编译 器 会 提示 包 不 存在 )。 

你 的 构建 工具 应 该 能 够 帮助 处 理 依赖 ( Maven : copy-dependencies )。 对 于 代码 而 言 ， 重 要 的 
是 编译 器 能 看 到 整个 模块 ， 而 不 仅仅 是 模块 声明 。 在 编译 声明 时 ， 最 好 通过 --patch-modqule 
选项 更 新 JAR 的 字 节 码 。7.2.4 节 介 绍 过 这 个 选项 ， 下 面 的 例子 展示 了 如 何 使 用 它 。 


为 所 有 JAR 生成 模块 声明 
(尽管 只 对 ${jar} 感 兴趣 ) 






















































































和 SS jdeps --generate-module-info . jars 按照 你 的 需求 ， 编 辑 
# edit ${module-name}/module-info.java 模块 声明 文件 
> $ javac 
~-module-path jars 将 ${jar} 的 模块 描述 符 
--patch-module S${module-name}=jars/${jar} 移动 到 根 目 录 (和 否则， 将 
$s{module-name}/module-info.java 无 法 更 新 JAR) 
$ mv ${module-name}/module-info.java . 


$ jar --update --file jars/${jar} module-info.class 十 将 模块 描述 符 添加 到 


$ jar --describe-module --file jars/$s{jar} a. 

使 用 jars 作为 模块 路 径 编 译 模块 声 | 

明 ， 用 --patch-module 选项 将 模块 

的 字 节 码 打 补丁 到 模块 中 
3. 向 模块 中 添加 类 
如 果 需 要 向 依赖 的 包 中 添加 一 些 类 , 那么 你 可 能 已 经 将 它们 放 在 了 类 路 径 上 。 但 是 ,一 旦 该 

依赖 项 转移 到 模块 路 径 ， 规 避 包 分 裂 的 规则 将 导致 此 方法 无 法 工作 。7.2.4 节 展 示 过 如 何 使 用 

--patch-module 选项 动态 处 理 这 种 情况 。 如 果 你 正在 寻找 一 个 终极 解决 方案 ， 可 以 再 次 使 用 

jar --update。 本 例 中 ， 它 将 添加 类 文件 。 


9.3.4 发 布 Java 8 及 更 老 版 本 的 模块 化 JAR 


无 论 你 维护 的 是 应 用 程序 、 类 库 还 是 框架 ， 都 可 能 需要 支持 多 个 Java 版 本 。 这 是 否 意 味 着 
不 能 使 用 模块 系统 ?幸好 不 是 这 样 。 有 两 种 方法 可 以 用 于 交付 在 Java 9 以 前 版 本 中 运行 良好 的 模 
块 化 工件 。 

无 论 选 择 哪 种 方法 ， 首先 都 需要 为 目标 版 本 构建 项 目 。 设 置 -source 和 -target 后 ， 可 以 
使 用 对 应 的 JD 玉 编译 器 ， 也 可 以 使 用 更 新 版 本 的 编译 器 。 如 果 选 择 Java 9 及 以 上 版 本 的 编译 器 ， 
请 查看 4.4 节 中 的 新 标志 --release。 像 往常 一 样 创建 JAR 即 可 完成 这 步 操作 。 注 意 , 尽管 这 个 
JAR 在 你 想 要 的 Java 发 行 版 中 运行 得 很 好 ， 但 是 它 尚 不 包含 模块 描述 符 。 

下 一 步 是 用 Java 9 及 以 上 版 本 编译 模块 声明 , 最 好 且 最 可 靠 的 方法 是 使 用 Java 9 及 以 上 版 本 
编译 需 构 建 整个 项 目 。 现 在 ， 在 将 模块 描述 符 放 和 人 JAR 方 面 ， 有 下 面 描述 的 两 个 选项 。 


验证 一 切 正常 ， 模 块 现在 
应 该 具有 所 需 的 属性 
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1. 使 用 jar --update 

可 以 使 用 jar --update (参见 9.3.3 节 ) 将 模块 描述 符 添加 到 JAR 中 。 因 为 版 本 9 之 前 的 
JVM 会 忽略 模块 描述 符 ， 所 以 这 个 方法 行 得 通 。 因 为 JVM 只 看 其 他 类 文件 ， 并 且 你 用 正确 的 版 
本 构建 了 JAR， 所 以 一 切 运行 正常 。 

虽然 对 于 JVM 来 说 这 是 正确 的 ， 但 并 不 是 所 有 处 理 字 节 码 的 工具 都 可 以 这 样 做 。 有 些 工 具 
会 卡 在 module-info.class 上 ， 最 终 变 得 对 模块 化 JAR 毫 无 用 处 。 想 避免 这 种 情况 ， 必 须 创 
建 多 版 本 的 JAR。 


2. 创建 多 版 本 的 JAR 
从 Java9 开始 ，jar 允许 创建 多 版 本 的 JAR (Multi-Release JAR，MR-JAR ), 而 其 中 包含 不 
同 Java 版 本 的 字 节 码 。 附 录 卫 详细 介绍 了 这 个 新 特性 ， 要 充分 理解 本 节 ， 你 应 该 读 一 读 附录 E。 
本 节 主 要 关注 如 何 使 用 MR-JAR， 以 使 JAR 的 根 目录 不 包含 模块 描述 符 。 
假设 你 有 一 个 普通 JAR, 并 希望 将 其 转换 为 一 个 多 版 本 的 JAR, 以 便 在 Java9 及 以 上 版 本 中 
加 载 模块 描述 符 。 下 面 ， 使 用 --updaate 和 --release 选项 来 做 到 这 一 点 。 
$ jar --update 
--file ${jar} 
--release 9 
module-info.class 


你 也 可 以 一 次 性 创建 多 版 本 的 JAR。 


S$ Jar -Feate 
--file mr.jar 


-C classes . 
--release 9 


classes-9/module-info.class 




















前 3 行 是 基于 classes 中 的 类 文件 创建 JAR 的 常规 方法 ， 然 后 是 --release 9， 随 后 是 Java 9 
及 以 上 版 本 要 加 载 的 模块 描述 符 文 件 。 如 图 9-7 所 示 ， 根 目录 不 包含 module-info.class。 


JAR 包 作为 目录 放 在 通常 的 位 置 
加 og 一 


















































codetx 类 文件 放 在 通常 的 位 轩 
国 Main.class 
目 .… A 可 选 信息 的 目录 
国 META-INF ee 
7 图 versions < 一 一 一 从 Java 9 开始 ，JVM 将 在 META-INF/ 
辆 9 versions 中 寻找 字 节 码 





目 module-info.class < 一 一 一 模块 描述 符 只 会 在 Java 9 及 以 上 
版 本 中 被 加 载 ， 因 为 它 在 META- 
INF/versions/9 中 
图 9-7 通过 创建 多 版 本 的 JAR， 你 可 以 将 模块 描述 符 放 在 META-INF/versions/9 中 ， 
而 不 是 工件 的 根 目录 中 
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口 如 果 你 还 没有 使 用 Java 8， 请 先 更 新 到 该 版 本 。 如 果 初 步 分 析 显 示 ， 有 一 些 依赖 关系 在 
Java 9 及 以 上 版 本 中 会 出 问题 ， 那 么 接 下 来 先 更 新 它们 。 这 将 确保 一 次 只 执行 一 个 步 又 ， 
将 复杂 性 降 到 最 低 。 

口 你 可 以 采取 以 下 措施 来 分 析 迁 移 中 的 问题 。 

四 使 用 Java 9 及 以 上 版 本 构建 应 用 程序 ， 并 实施 快速 修复 ( --add-modules、--adqd- 
exports、--add-opens 、--patch-module 和 其 他 选项 ) 来 获取 更 多 信息 。 

m 使 用 JDeps 查找 包 分 裂 和 针对 内 部 API 的 依赖 关系 。 

和 搜索 导致 问题 的 特定 模式 ， 比 如 : URLC1assLoader 的 强制 转换 和 使 用 已 删除 的 JVM 
机 制 。 

口 在 收集 完 这 些 信息 之 后 ， 进 行 正确 评估 很 重要 。 快 速 修 复 的 风险 是 什么 ?正确 地 解决 这 

些 问题 有 多 难 ? 受 影响 的 代码 对 项 目 有 多 重要 ? 

口 当 开 始 迁移 时 ， 要 不 断 地 对 变更 进行 构建 。 最 好 从 团队 其 他 成 员 使 用 的 相同 分 支 开始 ， 

以 确保 Java9 及 以 上 版 本 工作 和 常规 开发 能 够 很 好 地 集成 。 

口 命令 行 选项 使 你 能 够 快速 地 解决 在 Java 9 及 以 上 版 本 中 进行 构建 时 所 面临 的 挑战 。 但 是 
注意 不 要 使 用 它们 太 久 ， 因 为 它们 容易 使 人 忽略 问题 ,导致 未 来 的 Java 版 本 将 问题 恶化 。 
相反 ， 要 朝 着 长 期 解决 方案 努力 。 

口 有 3 种 模块 化 策略 。 整 个 项 目 采 用 哪 一 种 策略 ， 要 取决 于 项 目的 类 型 和 依赖 关系 。 

到 自 下 而 上 适用 于 只 依赖 模块 的 项 目 。 创 建 模块 声明 ， 并 将 所 有 依赖 项 放 在 模块 路 径 上 。 

里 自 上 而 下 适用 于 依赖 尚未 全 部 模块 化 的 应 用 程序 。 可 以 创建 模块 声明 并 将 所 有 直接 依 
赖 放 在 模块 路 径 上 ， 这 样 普通 的 JAR 会 被 转换 为 可 以 依赖 的 自动 模块 。 

里 由 内 而 外 适用 于 依赖 关系 尚未 全 部 模块 化 的 类 库 和 框架 。 它 的 工作 方式 类 似 自 上 向 下 ， 
但 是 有 一 个 限制 ， 即 只 能 使 用 定义 了 Automatic-Module-Name 的 manifest 条 目的 自 
动 模块 。 否 则 ， 自 动 模块 名 称 在 不 同 的 构建 和 时 间 上 都 是 不 稳定 的 ， 这 可 能 会 给 用 户 
带 来 严重 的 问题 。 

a 在 项 目 中 ， 你 可 以 选择 符合 其 特定 结构 的 任何 策略 。 

口 在 JDeps 中 可 以 使 用 jdeps --generate-module-info 自动 生成 模块 声明 。 这 对 大 型 

项 目 尤其 有 用 ， 因 为 手动 编写 模块 声明 将 花费 大 量 时 间 。 

口 jar 工具 的 --update 选项 可 以 用 于 修改 已 有 的 JAR, 例如 : 设置 Automatic-Module- 
Name 、 添 加 或 覆盖 模块 描述 符 。 如 果 依 赖 的 JAR 有 问题 ， 无 法 修复 ， 那 么 这 将 是 解决 问 
题 的 最 佳 利器 。 

口 通过 为 更 早 Java 版 本 的 源 代码 进行 编译 和 打包 ， 然 后 添加 模块 描述 符 ( 在 JAR 根 目录 中 
或 使 用 jar --version 指定 Java 9 及 以 上 版 本 具体 的 子 目 录 )， 你 可 以 创建 支持 多 Java 
版 本 的 模块 化 JAR。 并 且 ， 如 果 将 其 放 在 Java 9 模块 路 径 上 ， 它 将 作为 模块 而 存在 。 
































































































































模块 系统 高 级 特性 





本 书 第 一 部 分 和 第 二 部 分 类 似 于 拥有 前 菜 、 主 菜 、 汤 和 甜点 的 正餐 ,而 第 三 部 分 更 像 是 自助 
餐 ， 它 介绍 了 模块 系统 的 高 级 功能 ， 你 可 以 按 自己 喜欢 的 顺序 随意 选择 最 感 兴趣 的 章节 。 
第 10 章 介绍 了 服务 ， 这 是 一 种 将 用 户 和 API 实现 解 耦 的 好 机 制 。 如 果 你 对 优化 requires 
和 exports 指令 更 感 兴趣 ( 例如， 对 可 选 依赖 建 模 )， 请 阅读 第 11 章 。 接 下 来 再 阅读 第 12 章 ， 
准备 让 你 的 模块 接受 框架 的 反射 访问 ， 并 学 习 如 何 更 新 与 反射 相关 的 代码 。 

模块 系统 不 处 理 模块 版 本 信息 ， 但 是 你 可 以 在 构建 模块 时 记录 版 本 ， 并 在 运行 时 进行 评估 。 
第 13 章 探讨 了 这 一 点 ， 以 及 没有 对 版 本 提供 进一步 支持 的 原因 ， 比 如 为 什么 不 支持 同时 运行 一 
个 模块 的 多 个 版 本 。 
第 14 章 从 模块 开发 中 后 退 一 步 ， 将 模块 视 为 创建 自 定义 运行 时 镜像 ( 其 中 包含 运行 项 目 所 
需 的 模块 ) 的 输入 。 更 进一步 ,你 甚至 可 以 守 括 整个 应 用 程序 ， 并 创建 单一 的 可 部 署 单元 ， 以 交 
付 给 客户 或 服务 器 。 

最 后 ， 第 15 章 综合 上 述 内 容 ， 展 示 了 ServiceMonitor 应 用 程序 的 另 一 个 版 本 ( 该 版 本 使 用 
了 模块 系统 的 大 多 数 高 级 特性 )， 给 出 了 设计 和 维护 模块 化 应 用 程序 的 技巧 ， 并 对 Java 的 未 来 进 
行 了 大 胆 描述 : 成 为 一 个 模块 化 生态 系统 。 

顺便 说 一 下 ,这 些 特性 并 不 比 基 本 机 制 更 复杂 ， 只 是 它们 构建 在 基础 机 制 之 上 ， 因 此 需要 更 
多 关于 模块 系统 的 背景 知识 。 如 果 你 已 经 读 了 第 一 部 分 (特别 是 第 3 章 )， 就 可 以 开始 阅读 本 部 
分 了 。 

(尽管 前 面 已 经 多 次 提 到 , 但 是 这 里 仍 要 再 次 强调 : 请 记 住 , 本 书 使 用 的 模块 名 称 被 缩短 了 ， 
以 便于 对 其 进行 描述 。 在 真实 的 代码 中 ， 请 使 用 3.1.3 节 中 描述 的 反 向 域 命 名 方案 。) 
































































































































用 服务 来 解 看 模块 








本 章 内 容 

口 通过 服务 改进 项 目 设 计 

口 在 JPMS 中 创建 服务 、 消 费 者 和 提供 者 

口 通过 ServiceLoader 消费 服务 

口 开发 设计 良好 的 服务 

口 在 不 同 的 Java 版 本 之 间 用 普通 JAR 和 模块 化 JAR 来 部 署 服务 





目前 为 止 , 本 书 用 requires 指令 表示 模块 之 间 的 依赖 关系 , 其 中 模块 必须 按 名 称 引用 每 个 
特定 的 依赖 。 正如 3.2 节 详 细 解 释 的 那样 , 这 是 可 靠 配 置 的 核心 , 但 有 时 你 需要 更 高 层次 的 抽象 。 

本 章 将 探讨 模块 系统 中 的 服务 ,以 及 如 何 使 用 服务 消除 模块 之 间 的 直接 依赖 关系 ,以 实现 模 
块 之 间 的 解 耦 。 使 用 服务 解决 问题 的 第 一 步 是 掌握 基础 知识 。 接 下 来 ,本章 将 研究 其 细节 ， 特 别 
是 如 何 正确 地 设计 服务 ( 参见 10.3 节 )， 以 及 如 何 使 用 JDK 的 API 来 消费 服务 (参见 10.4 家 。 
(要 了 解 服务 实践 ， 请 查看 ServiceMonitor 仓库 的 feature-services 分 支 。) 

读 完 本 章 ， 你 将 了 解 如 何 设计 好 服务 、 如 何 为 使 用 或 提供 服务 的 模块 编写 模块 声明 ， 以 及 如 
何在 运行 时 加 载 服务 。 借 助 这 些 技能 ， 你 可 以 使 用 JDK 或 第 三 方 依赖 中 的 服务 ， 以 及 移 除 自己 
项 目 中 的 直接 依赖 。 


10.1 探索 对 服务 的 需求 


如 果 本 书 讨论 的 是 类 而 不 是 模块 , 你 是 否 乐于 总 是 依赖 于 具体 的 类 型 ? 或 者 必须 在 类 中 实例 
化 每 个 依赖 ?” 如 果 你 喜欢 诸如 控制 反 转 和 依赖 注 和 人 之 类 的 设计 模式 ， 那 么 此 时 应 该 强烈 地 摇头 。 
将 代码 清单 10-1 和 代码 清单 10-2 进行 比较 ， 后 者 看 起 来 不 是 更 好 吗 ? 调用 者 可 以 选择 最 合适 的 
流 处 理工 具 ， 甚 至 可 以 自由 选择 任何 Inputstream 的 实现 。 


代码 清单 10-1 依赖 于 具体 类 型 建立 依赖 关系 


public class InputStreamAwesomizer { 

















































































































| 依赖 于 具体 类 型 


private final ByteArrayInputStream stream; < 
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public AwesomeInputStream(byte[] buffer) { 


stream = new ByteArrayInputSstream(buffer); 
} 直接 建立 
依赖 关系 
// […… 与 本 类 相关 的 方法 ……] 


代码 清单 10-2 依赖 于 抽象 类 型 ; 调用 者 建立 依赖 关系 


public class InputStreamAwesomizer { 


依赖 于 抽象 类 型 


private final InputStream stream; 


public AwesomeInputStream(InputStream stream) { 
this.stream = stream; 


} 调用 者 建立 
依赖 关系 
// […… 与 本 类 相关 的 方法 ……] 


依赖 接口 或 抽象 类 , 让 其 他 人 选择 具体 实例 的 另 一 个 重要 好 处 是 , 这 样 做 会 逆转 依赖 关系 的 
方向 。 与 高 级 概念 ( 比如 Department ) 依赖 于 低级 细节 ( secretary、Clerk 和 Manager ) 
不 同 ， 两 者 都 可 以 依赖 于 抽象 ( Employee )。 如 图 10-1 所 示 ， 这 打破 了 高 级 概念 和 低级 概念 
间 的 依赖 关系 ， 从 而 将 它们 解 耦 。 


Input streamAwesomizer 只 能 创建 这 个 具体 类 


建立 依赖 \, 
_ creates 




















“* internally 


pe InputStream depends ByteArray 
: Awesomizer InputStream 
passes 
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extends 
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Awesomizer 


ByteArray 
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creates and passes 











由 InputStreamAwesomizer 的 可 以 创建 各 种 类 型 
户 建立 依赖 的 具体 类 

















10-1 ”如果 一 个 类 型 建立 了 自己 的 依赖 关系 (上 )， 用 户 就 不 能 对 这 些 关系 进行 更 改 。 
如 果 在 构造 期 间 传 递 类 型 的 依赖 (下 )， 那 么 用 户 可 以 选择 最 适合 的 实现 
回 到 模块 ，requires 指令 很 像 代码 清单 10-1 中 的 代码 ， 但 是 它们 在 不 同 的 抽象 级 别 上 。 
口 模块 依赖 于 其 他 具体 模块 。 
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口 用 户 无 法 更 改 依赖 。 

口 没有 办 法 反 转 依赖 关系 。 

幸运 的 是 , 模块 系统 没有 这 样 做 。 模块 系统 提供 了 服务 , 一 种 让 模块 表示 其 依赖 于 抽象 类 型 ， 
或 可 以 提供 实现 依赖 的 具体 类 型 的 方法 ， 而 模块 系统 位 于 中 间 , 在 它们 之 间 进 行 协 商 ( 如 果 你 现 
在 想到 的 是 服务 定位 融 模 式 ， 那 就 完全 正确 了 )。 下 文 将 提 到 ， 尽 管 服务 并 不 能 完美 地 解决 所 有 
问题 ， 但 它 确 实 已 经 解决 了 许多 问题 ， 图 10-2 展示 了 两 种 类 型 的 依赖 关系 。 


模块 建立 的 依赖 





























some.module requires other.module 





ll 
本 ca OtherClass 













other.module 






OtherClass 








some.module 
ppp | 


SomeClass 
passes on 


or 
人 
模块 系统 建立 的 依赖 


图 10-2 如果 一 个 模块 依赖 于 另 一 个 模块 (上 )， 那 么 依赖 是 固定 的 ， 不 能 
从 外 部 改变 ; 另 一 方面 ， 如 果 模 块 使 用 服务 (下 )， 那 么 在 运行 时 
可 选择 最 合适 的 具体 实现 





























10.2 JPMS 中 的 服务 


当 在 JPMS 的 背景 中 讨论 服务 时 ,会 涉及 想 要 使 用 的 特定 类 型 ， 它 通常 是 一 个 接口 , 但 是 人 
们 没有 将 它 的 实现 实例 化 。 相 反 , 模块 系统 采用 宣称 实现 了 对 应 功能 的 其 他 模块 ,并 将 实现 实例 
化 。 本 市 将 详细 介绍 该 流程 的 工作 原理 ,以 便 你 了 解 应 该 在 模块 描述 符 中 放 入 什么 、 如 何在 运行 
时 获取 实例 ， 以 及 这 将 如 何 影 响 模块 解析 。 


10.2.1 ” 使用、 提供 和 消费 服务 


服务 是 一 个 模块 想 要 使 用 的 可 访问 类 型 ， 而 另 一 个 模块 提供 了 实现 实例 。 
口 消费 服务 的 模块 在 其 模块 描述 符 中 使 用 uses $s{service} 指 令 表 示 其 需求 , 其 中 $s {service} 
是 服务 类 型 的 完全 限定 名 。 
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口 提供 服务 的 模块 用 provides ${service} with ${provider} 指 令 来 表示 其 提供 服务 ， 
其 中 $ {service} 与 uses 指令 中 的 类 型 相同 , 而 $ {provider} 是 男 一 个 类 的 完全 限定 名 
称 。 该 类 可 以 是 以 下 两 个 类 中 的 任何 一 个 。 
昌 扩展 或 实现 $S{service}， 并 具有 公有 无 参 构造 函数 (被 称 为 提供 程序 构造 器 ) 的 具 
体 类 。 
@ 使 用 公有 、 静 态 、 无 参数 的 方法 并 返回 任意 类 型 , 该 类 型 扩展 或 实现 了 s {service}( 被 
称 为 提供 者 方法 )。 
运行 时 ， 依 赖 模块 可 以 通过 ServiceLoader 类 调用 serviceLoader.load(${service}. 
class)， 以 获取 服务 的 所 有 提供 者 实现 。 然 后 ， 模 块 系统 为 模块 图 中 声明 的 每 个 提供 者 返回 
个 Provider<${service}>， 图 10-3 演示 了 提供 者 的 实现 。 



































消费 者 和 提供 者 
三 依赖 于 服务 和 
consuming serving providing 




























requires requires 


FE 





implements 





module consuming { Uses 


requires serving; 
uses serve.Serving; 
: module providing { 
requires serving; 
provides serve.Service 
with provide.Provider; 




















\ J 





消费 者 通过 调用 ServiceLoader 

来 加 载 所 有 的 服务 提供 者 

图 10-3 ”使 用 服务 的 核心 是 特定 的 类 型 ， 这 里 称 为 Service。Provigder 类 实现 了 Service， 
其 模块 声明 包含 broviaes -with 指令 。 消 费 服务 的 模块 需要 使 用 uses 指令 。 在 
运行 时 ， 可 以 使 用 serviceLoader 获取 给 定 服务 的 所 有 提供 者 实例 


尽管 围绕 服务 有 很 多 细节 需要 考虑 , 但 一 般 来 说 ,服务 是 一 个 很 好 的 抽象 概念 ， 并 且 在 实践 
中 使 用 很 方便 ， 所 以 本 节 从 这 里 开始 。 实 施 服 务 比 输入 一 个 requires 或 exports 指令 要 花 更 
长 的 时 间 。 

ServiceMonitor 应 用 程序 为 实践 服务 提供 了 一 个 完美 的 示例 。monitor 模块 中 的 monitor 
类 需要 List<Serviceobserver> 与 其 监视 的 服务 之 间 进 行 通信 。 到 目前 为 止 ，Main 的 工作 
如 下 。 
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Private static Optional<ServiceObserver> createObserver (String serviceName) 
return AlphaServiceObserver.createIfAlphaService(serviceName) 
-> BetaServiceObserver.createlfBetaService (serviceName)); 





{ 


Et 


} 
代码 的 具体 工作 方式 并 不 十 分 重要 。 与 之 相关 的 是 ， 它 使 用 monitor.observer.alpha 模块 中 的 


具体 类 型 AlphaserviceObserver 和 monitor.observer.beta 模块 中 的 类 型 BetaService- 


Observer。 因 此 monitor 模块 需要 依赖 于 这 些 模块 ， 并 且 这 些 模块 需要 导出 相应 的 包 。 图 10-4 
展示 了 模块 图 中 的 相关 部 分 。 





monitor.observer 


monitor requires 


SomeClass 


消费 者 依赖 于 
抽象 和 | 实现 











implements 


消费 者 自己 对 实现 进行 实例 化 


图 10-4 在 没有 服务 的 情况 下 ，monitor 模块 需要 依赖 所 有 其 他 相关 的 模块 : 
observer 、alpha 和 beta， 如 部 分 模块 图 所 示 








现在 把 注意 力 转 向 服务 。 第 一 步 ， 创建 这 些 observer 的 模块 需要 声明 依赖 一 个 服务 ,并 日 使 
用 serviceobserver， 因 此 monitor 的 模块 声明 如 下 。 





module monitor { 
// […… 省 略 了 requires 指令 ……] 
// 移 除了 对 monitor.observer.alpha 和 monitor.observer .beta 的 依赖 | 


uses monitor.observer.ServiceObserver; 


} 


下 一 步 是 提供 


module monitor.observer.alpha { 
requires monitor.observer; 
// 移 除 了 monitor.observer.alpha 的 导出 ! 
provides monitor.observer.ServiceObserver 
with monitor.observer.alpha.AlphaServiceObserver; 





者 模块 monitor.observer.alpha 和 monitor.observer.beta 进行 provides 指令 声明 。 


这 样 并 不 能 正常 工作 ， 编 译 器 会 报告 如 下 错误 。 
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> The service implementation does not have 
> a public default constructor: 
> AlphaServiceObserver 





提供 者 构造 明 数 和 提 代 者 方法 必须 是 无 参数 的 , 但 是 ph vie ee 需要 观察 服 
务 的 URL， 这 该 怎么 办 ?你 可 以 在 创建 后 再 设置 URL， 但 这 样 不 仅 会 让 类 变 得 不 确定 ， 还 会 产 
生 一 个 问题 : 如 果 服 务 不 是 alpha 该 怎么 办 ”因此 ， 不 应 Y 该 这 样 做 ， 人 observer 的 工厂 
方法 ， 该 方法 仅 在 URL 正确 的 情况 下 返回 一 个 实例 ， 这 样 更 简洁 。 

因此 , 在 monitor.observer 中 创建 一 个 新 的 接口 ServiceObserverFactory。 它 只 有 一 个 方 
法 createIfMatchingService， 该 方法 接收 服务 URL 并 返回 一 个 optional<Service- 
Observer>。 在 monitor.observer.alpha 和 monitor.observer.beta 模块 中 分 别 创建 实现 ， 以 执行 
AlphaServiceObserver 和 BetaServiceObserver 上 的 静态 工厂 方法 应 该 做 的 工作 ,图 10-5 
显示 了 模块 图 的 对 应 部 分 。 


消费 者 不 再 实例 化 消费 者 只 依赖 抽象 
具体 的 实现 














monitor requires monitor.observer 


ServiceObserver 
ED 


requires 














monitor.observer.alpha 


| 
ER 


monitor.observer.beta 





BetaService 
ObserverFactory 


implements and provides 











10-5 通过 服务 ，monitor 只 依赖 定义 服务 的 模块 observer， 而 不 再 直接 依 
赖 提供 服务 的 模块 alpha 和 beta 


使 用 这 些 类 , 你 能 以 服务 的 方式 提供 和 消费 ServiceObserverFactory 类 。, 代码 清单 10-3 


展示 了 monitor、monitor.observer、monitor.observer.alpha 和 monitor.observer.beta 的 模块 声明 。 














代码 清单 10-3 使 用 serviceObserverFactory 的 4 个 模块 


消费 者 模块 monitor 依赖 于 monitor.observer, 因 关 
包含 ServiceObserverFactory; 多 亏 了 这 些 服务 ， 
现在 它 既 不 依赖 于 alpha 也 不 依赖 于 beta 

module monitor { 
requires monitor.observer; 
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monitor.observer 没有 任何 变化 : 不 知道 它 被 用 作 
服务 ， 所 需要 的 只 是 包含 serviceobserver 和 


ServiceObserverFactory 的 包 的 常规 导出 


// [... truncated other requires directives ...] 
, uses monitor.observer.ServiceObserverFactory; < 消费 者 模块 monitor 使 用 
服务 的 接口 service- 
ObserverFactory 
module monitor.observer { - 


exports monitor.observer; 


} 


两 个 提供 者 模块 都 依赖 于 monitor.observer 
module monitor.observer.alpha { 模块 ， 因 为 它们 实现 了 它 所 包含 的 接口 一 一 
requires monitor.observer; 服务 没有 改变 任何 东西 


provides monitor.observer.ServiceObserverFactory 
with monitor.observer.alpha.AlphaServiceObserverFactory; -<< 


} 
每 个 提供 者 模块 都 向 服务 


module monitor.observer.beta { Seryiceobseryeriactory 
旦 S 
requires monitor.observer; 提供 其 具体 实现 类 


provides monitor.observer.ServiceObserverFactory 
with monitor.observer.beta.BetaServiceObserverFactory; 





} 





最 后 一 步 是 在 monitor 中 获得 observer 工厂 。 为 此 , 调用 serviceLoader.1load(Service- 
ObserverFactory.class)， 对 返回 的 提供 者 进行 流 处 理 ， 得 到 服务 实现 。 


List<ServiceObserverFactory> observerFactories = ServiceLoader 
.load (ServiceObserverFactory.class) .stream() 
.map (Provider: :get) 
.Collect (toList()); 








Provider: :get 实例 化 
提供 者 (参见 10.4.2 节 ) 


就 是 这 样 : 有 一 堆 服 务 提供 者 ,而 模块 消费 者 和 模块 提供 者 对 彼此 一 无 所 知 ， 它们 唯一 的 联 
系 是 二 者 依赖 于 API 模 块 。 
平台 模块 还 声明 和 使 用 了 大 量 的 服务 。 一 个 特别 有 趣 的 例子 是 由 java.sql 模块 声明 和 使 用 的 


java.sql.Drivero 























$ java --describe-module java.sql 


> java.sqgl 

# 省 略 了 exports 

# 省 略 了 frequires 

> uses java.sql.Driver 


这 样 ，java.sql 可 以 访问 其 他 模块 提供 的 所 有 Driver 实现 。 

平台 中 使 用 服务 的 男 一 个 典型 例子 是 java .1lang .System.LoggerFinder。 这 是 Java9 中 
新 添加 的 一 个 API， 它 使 用 户 能 将 JDK ( 而 不 是 JVM ) 的 日 志 消 息 导入 所 选择 的 日 志 框 架 ( 例 
如 Log4J 或 Logback )。JDK 使 用 LoggerFinger 创建 Logger 实例 ， 然 后 用 这 些 实例 记录 所 有 
消息 ， 而 不 是 输出 到 标准 输出 中 。 

在 Java9 及 以 上 版 本 中 , 日 志 框 架 可 以 实现 日 志 的 工厂 方法 ,并 在 工厂 方法 中 利用 框架 的 基 
础 设施 。 
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public class ForesterFinder extends LoggerFinder { 


下 |] 属于 虚拟 的 Forester 
日 志 框架 


@Override 
public Logger getLogger (String name, Module module) { 
return new Forester (name, module); 


} 
} 


但 是 日 志 框 架 如 何 将 LoggerFinder 的 实现 通知 给 java.base 呢 ? 很 简单 ， 它 们 为 
LoggerFinder 服务 提供 自己 的 实现 。 








module org.forester { 
provides java.lang.System.LoggerFinder 
with org.forester.ForesterFinder; 


} 


这 之 所 以 行 得 通 , 是 因为 基本 模块 使 用 LoggerFinder, 然后 调用 serviceLoader 来 定位 
LoggerFinder 的 实现 。 它 获得 了 一 个 特定 于 框架 的 查找 髓 ， 借助 它 创 建 Logger 实现 ， 然后 使 
用 这 些 实现 来 记录 消息 。 

这 将 使 你 对 创建 和 使 用 服务 在 细节 上 有 一 个 更 加 清晰 的 认识 。 


10.2.2 ”服务 的 模块 解析 


如 果 你 曾经 启动 过 一 个 简单 的 模块 化 应 用 程序 ,并 且 观 察 过 模块 系统 正在 做 什么 ( 例如, 使 
用 --show-module-resolution， 如 5.3.6 节 所 述 )， 那 么 可 能 会 对 所 解析 的 平台 模块 的 数量 感 
到 人 惊讶。 对 ServiceMonitor 这 样 的 简单 应 用 程序 而 言 ， 唯 一 的 平台 模块 应 该 是 java.base， 最 多 有 
一 两 个 其 他 模块 。 那 么 为 什么 有 这 么 多 其 他 模块 呢 ? 答案 就 是 服务 。 


要 点 ”请 记 住 ，3.4.3 节 曾 介绍 过 ， 只 有 在 模块 解析 期 间 进 入 模块 图 的 模块 在 运行 
时 才 可 用 。 为 了 确保 对 服务 的 所 有 可 见 提供 者 而 言 都 是 这 样 ， 解 决 方案 需要 考虑 
uses 和 provides 指令 。 除 3.4.1 节 描 述 的 解析 行为 外 ,一 旦 解析 到 一 个 使 用 服 
务 的 模块 ， 它 将 把 所 有 可 观察 的 模块 添加 到 提供 该 服务 的 图 中 ， 这 被 称 为 绑 定 。 























用 选项 - -show-modqule-resolution 启动 ServiceMonitor 应 用 程序 会 出 现 大 量 的 服务 绑 定 。 


$ java 
--Sshow-module-resolution 
--module-path mods:libs 
--module monitor 


root monitor 

monitor requires monitor.observer 

省 略 了 很 多 模块 解析 

monitor binds monitor.observer.beta 

monitor binds monitor.observer.alpha 

java.base binds jdk.charsets jrt:/jdk.charsets 


V VV 站 VYV 
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> java.base binds jdk.localedata jrt:/jdk.localedata 
# 省 略 了 大 量 对 java.base 的 绑 定 信息 
# 省 略 了 其 余 模 块 解析 





monitor 模块 绑 定 了 monitor.observer.alpha 和 monitor.observer.beta 模块 ,但 是 并 不 依赖 于 它们 
中 的 任何 一 个 。 归 因 于 java.base 和 其 他 平台 模块 , 同样 的 情况 也 适用 于 jdk.charsets 、jdk.localedata 
以 及 更 多 模块 。 图 10-6 展示 了 相关 的 模块 图 。 


添加 到 了 模块 图 中 ， 因 为 monitor 
使 用 了 它们 提供 的 服务 










requires 







monitor monitor.observer 











requires 










monitor.observer.alpha monitor.observer.beta 


J 








requires 














java.base jdk.charsets jdk.localedata 





全 


添加 到 了 模块 图 中 ， 因 为 java.base 
使 用 了 它们 提供 的 服务 
图 10-6 服务 绑 定 是 模块 解析 的 一 部 分 : 一 旦 某 个 模块 ( 比如 monitor 或 java.base ) 被 解 
析 , 它 的 uses 指令 会 被 分 析 , 并 且 提 供 所 对 应 的 服务 的 所 有 模块 (alpha 和 beta 
以 及 charsets 和 localedata ) 都 会 被 添加 到 模块 图 中 











用 --1imit-modules 排除 服务 
服务 和 --1imit-modules 选项 之 间 具 有 有 趣 的 交互 。 如 5.3.5 节 所 述 ，--1limit-modules 
将 可 见 模 块 全 集 限制 到 指定 的 范围 ( 包括 传递 依赖 ), 但 这 并 不 包含 服务 ! 除 非 --1limit-mogdules 
选项 所 列 出 的 模块 传递 性 地 依赖 于 提供 的 服务 ， 否 则 它们 是 不 可 见 的， 也 不 会 被 放 入 模块 图 中 。 
在 这 种 情况 下 ， 对 ServiceLoader: :1oad 的 调用 通常 会 一 无 所 获 。 
如 果 像 检查 模块 解析 那样 启动 ServiceMonitor， 但 是 将 可 见 模块 的 范围 限制 为 所 有 依赖 
monitor 的 模块 ， 输 出 则 会 更 简单 。 
S java 
--Sshow-module-resolution 
--module-path mods :1ibs 
--limit-modules monitor 
--module monitor 


root monitor 


# 省 略 了 monitor 的 传递 依赖 
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就 是 这 样 了 : 输出 中 没有 任何 服务 既 没 有 observer 工厂 ,也 没有 平台 模块 通常 绑 定 的 那 


些 服务 。 图 10-7 展示 了 本 示例 简化 的 模块 图 。 





java.base 
为 monitor 和 java.base 


提供 服务 的 模块 不 可 见 ， 
因此 不 被 解析 






图 10-7 通过 选项 --1imit-modules monitor， 可 见 模块 全 集 被 限制 为 monitor 模块 
的 传递 依赖 ， 不 包含 图 10-6 中 被 解析 的 服务 提供 者 











--limit-modules 和 --add-modules 的 结合 体 尤为 强大 : 前 者 可 被 用 于 排除 所 有 服务 ， 
后 者 可 以 用 来 将 所 期 望 的 服务 添加 回来 。 这 使 人 们 在 启动 期 间 可 以 尝试 不 同 的 服务 配置 , 而 不 用 
修改 模块 路 径 。 








为 什么 uses 指令 是 必须 的 

说 些 题 外 话 ， 在 此 回答 开发 者 们 一 个 关于 uses 指令 的 问题 。 为 什么 它 是 必需 的 ? 一 旦 
ServiceLoader::1o0ad 被 调用 ， 模 块 系统 就 不 能 直接 查找 服务 提供 者 了 吗 ? 

如 果 模 块 通过 服务 被 恰当 解 耦 ， 那 么 提供 服务 的 模块 很 可 能 不 是 任何 根 模 块 的 传递 依赖 。 
如 果 没 有 进一步 的 措施 ， 按 惯例 ， 服务 提供 者 模块 不 会 被 放 入 模块 图 中 。 因 此 ， 在 运行 时 ， 当 
某 个 模块 尝试 使 用 服务 时 ， 它 将 不 可 用 。 

为 了 让 这 些 服务 正常 工作 , 服务 提供 者 模块 必须 被 放 入 模块 图 中 , 即使 它们 不 受 任何 根 模 
块 传递 地 依赖 也 是 如 此 。 但 是 模块 系统 如 何 分 辩 哪 个 模块 提供 服务 ” 这 是 否 意味 着 所 有 带 
provides 指令 的 模块 都 可 以 ? 那样 就 太 多 了 。 答案 是 否定 的 ， 只 有 所 需 服务 的 提供 者 才 会 受 
到 解析 。 

这 样 就 有 必要 分 辨 服务 的 使 用 情况 。 分 析 调 用 ServiceLoader::1oad 的 字 节 码 既 耗 时 
又 不 可 靠 ， 所 以 人 们 需要 一 个 更 加 清晰 的 机 制 来 确保 其 高 效 、 正 确 ， 这 就 是 uses 指令 。 模 块 
系统 要 求人 们 声明 模块 使 用 的 服务 ， 从 而 可 靠 且 高 效 地 使 所 有 服务 提供 者 模块 可 用 。 





10.3 ”良好 地 设计 服务 


如 10.2 节 所 述 ， 服 务 有 4 个 要 素 。 

口 服务 (service ) 一 一 在 JPMS 中 即 一 个 类 或 者 一 个 接口 。 
口 消费 者 ( consumer ) 期 望 使 用 服务 的 任何 代码 片段 。 
口 提供 者 ( provider ) 服务 的 一 个 具体 实现 。 
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它 由 消费 者 的 请 求 触 发 ， 对 提供 者 进行 定位 并 将 其 返回 。 在 Java 
中 就 是 ServiceLoader。 

ServiceLoader (10.4 节 将 进一步 介绍 ) 由 JDK 提供 ,但 是 在 创建 服务 时 ， 男 外 3 个 由 你 
负责 。 你 为 服务 选择 哪些 类 型 (参见 10.3.1 节 )， 如 何 对 它们 进行 良好 的 设计 (参见 10.3.2 节 )? 
消费 者 依赖 于 危险 的 全 局 状态 ( 参见 10.3.3 节 )， 这 难道 不 是 很 奇怪 吗 ? 包含 服务 、 消 费 者 和 提 
供 者 的 模块 该 如 何 与 另 一 个 模块 进行 关联 (参见 10.3.4 节 ) ? 为 了 设计 优雅 的 服务 , 你 需要 能 够 
回答 这 些 问 题 。 

本 书 也 将 深入 解析 如 何 通过 服务 来 解决 模块 间 的 循环 依赖 问题 (参见 10.3.5 节 )。 最 后 ， 本 
书 将 讨论 服务 如 何在 跨越 普通 JAR 和 模块 化 JAR 的 情况 下 正常 工作 (参见 10.3.6 节 ), 对 于 计划 
在 不 同 的 Java 版 本 中 使 用 服务 的 开发 者 来 说 ， 这 一 点 非常 重要 。 


10.3.1 可 以 作为 服务 的 类 型 


服务 可 以 是 具体 类 ( 甚至 最 终 类 )、 抽 象 类 或 者 接口 。 虽 然 只 有 枚 举 没 有 被 包含 在 内 ， 但 是 
使 用 具体 类 ( 尤其 是 最 终 类 ) 作为 服务 不 符合 惯例 , 这 主要 是 因为 模块 的 依赖 应 该 是 抽象 的 。 除 
非特 殊 用 例 要 求 这 么 做 ， 否 则 服务 应 该 永远 是 抽象 类 或 者 接口 。 





口 定位 器 (locator ) 








































































































关于 抽象 类 

就 个 人 而 言 , 我 并 不 喜欢 过 深 的 类 层级 结构 ， 因 此 很 自然 地 对 抽象 类 有 些 抵触 。 由 于 Java 8 
使 人 们 能 在 接口 中 实现 方法 , 抽象 类 的 一 大 用 例 消失 了 : 为 具有 良好 默认 行为 的 接口 方法 提供 
基本 实现 。 

现在 我 主要 使 用 它们 为 实现 复杂 接口 提供 本 地 支持 (通常 是 包 范 围 内 或 者 内 部 类 ), 但 这 
里 要 注意 : 在 不 必要 的 情况 下 请 避免 将 它们 渗透 到 公有 API 中 。 我 以 这 种 方式 创建 的 任何 服 
务 一 属于 某 个 模块 的 公有 API 的 一 部 分 一 一 都 是 对 接口 的 实现 。 





10.3.2 ”将 工厂 用 作 服 务 


回 到 10.2.1 节 中 最 初 重 构 服 务 观察 者 架构 以 让 其 使 用 JPMS 服务 的 尝试 。 这 个 尝试 进行 的 不 

太 顺 利 ， 因 为 将 Serviceobserver 接口 用 作 服 务 ， 并 将 它 的 AlphaServiceObserver 和 
BetaServiceObserver 实现 用 作 服 务 提供 者 ， 会 有 一 些 问题 。 
口 服务 提供 者 需要 一 些 无 参数 的 提供 者 方法 或 构造 函数 ， 但 是 我 们 想 使 用 的 类 需要 以 一 个 
具体 且 不 能 改变 的 状态 来 完成 初始 化 。 
口 尽管 观察 者 实例 可 以 处 理 alpha 或 者 beta API， 但 要 让 它们 自己 决定 是 否 适 合 某 一 种 网 络 
服务 还 是 有 些 困 难 。 我 更 倾向 于 直接 用 正确 的 状态 创建 这 些 实例 。 
口 服务 加 载 器 会 缓存 服务 提供 者 〈( 10.4 节 中 会 有 更 多 讨论 )， 所 以 取决 于 你 如 何 使 用 这 些 APL， 

也 许 每 个 服务 提供 者 只 有 一 个 实例 ,在 本 例 中 有 一 个 AlphaServiceobserver 实例 和 一 


个 BetaServiceObserver 实例 。 
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这 使 得 直接 创建 所 需要 的 实例 变 得 不 太 现实 , 所 以 取而代之 , 可 以 使 用 工厂 来 创建 。 正 如 它 
所 表现 的 ， 这 并 不 是 一 个 特殊 的 例子 。 

对 于 消费 者 来 说 ， 不 论 要 连接 的 是 URL 还 是 日 志 的 名 称 ， 配 置 所 使 用 的 服务 都 是 必要 的 。 
消费 者 或 许 也 想 为 特定 的 服务 提供 者 创建 更 多 实例 。 如 果 将 服务 加 载 带 对 于 无 参 构造 函数 的 需求 
以 及 自由 缓存 实例 的 需求 放 在 一 起 考虑 , 那么 将 所 使 用 的 ServiceObserver 或 者 Logger 的 真 
实 类 型 作为 服务 就 不 现实 了 。 

相反 ， 为 需要 的 类 型 创建 工厂 ， 比如 ServiceObserv rFactory 或 者 LoggerFinder, 并 
且 将 它 用 作 服 务 是 很 常见 的 办 法 。 根 据 工厂 模式 ， 工 三 有 责任 用 正确 的 状态 创建 实例 。 因 此 ,这 
些 服务 的 设计 通常 变 得 很 简单 ， 以 至 于 它们 自己 没有 状态 ， 你 也 无 须 关 心 有 多 少 种 这 样 的 服务 。 
这 使 得 工厂 与 ServiceLoader 的 特点 非常 匹配 。 

并 且 这 里 还 有 至 少 两 个 额外 的 收获 。 

口 如 果实 例 化 所 需 类 型 的 代价 很 高 ， 那 么 为 它 实现 一 个 工厂 作为 服务 将 是 消费 者 控制 创建 

实例 时 机 的 最 简单 的 方式 。 

口 如 果 需 要 检查 某 个 提供 者 是 否 可 以 处 理 一 个 特定 的 输入 或 者 配置 ， 那 么 工厂 可 以 提供 一 
个 方法 来 指明 检查 结果 ,或 者 返回 一 个 类 型 用 来 指明 创建 某 个 对 象 ( 例如 ,一 个 optional 
对 象 ) 是 不 可 能 的 。 

本 书 将 展示 两 个 根据 对 某 种 情况 的 适用 性 选择 服务 的 例子 。 第 一 个 来 自 ServiceMonitor， 在 
这 个 例子 中 ， ServiceObserverFactory 没有 返回 ServiceObserver 的 create (String) 
方法 , 但 是 有 createI fMatchingService (String) 方 法 , 能 够 返回 一 个 optional<Service- 
Observer> 对 象 。 这 样 ， 人 们 就 可 以 传递 任何 URL 给 任意 工厂 ， 然 后 返回 值 会 提示 是 否 可 以 处 
理 这 个 URL。 

另 一 个 例子 是 不 使 用 serviceLoader， 而 使 用 JDK 中 一 个 类 似 但 不 常用 的 API， 即 
ServiceRegistry。 此 API 是 专门 为 Java 的 ImageIO API 创建 的 ， 用 来 根据 编码 器 为 指定 的 图 
像 选择 适当 的 ImageReader， 比 如 JPEG 或 PNG。 

Image IO 通过 向 注册 表 请 求 抽象 类 ImageReaderspi 的 实现 来 选择 读 取 者 , 而 注册 表 会 返回 诸 
如 JPEGImageReaderSpi 或 者 PNGImageReaderSpi 类 的 实例 。 接 着 对 每 一 个 ImageReaderSpi 
实现 调用 canDecodeInput (Object)， 如 果 文 件 头 表明 图 像 使 用 了 相应 的 编码 器 ， 则 返回 true。 
只 有 当 某 个 实现 返回 true 时 ， Image IO 才 会 调用 createReaderInstance (Object) 来 为 该 
图 像 创建 一 个 真正 的 读 取 者 。 图 10-8 展示 了 使 用 工厂 的 例子 。 
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图 10-8 ”将 期 望 的 类 型 作为 服务 ， 在 JDK 的 特性 下 通常 不 会 很 顺利 。 相 反 ， 请 考虑 设 
计 一 个 工厂 ， 用 正确 的 配置 创建 实例 ， 并 将 其 服务 化 


ImageReaderSpi 扮演 了 一 个 工厂 服务 ,使 用 canpecodqeInput 来 选择 正确 的 提供 者 ， 并 
使 用 createReaderInstance 来 创建 所 需 的 类 型 : 一 个 ImageReader 对 象 。 正 如 10.4.2 节 所 
述 ， 有 另 一 种 方法 来 选择 一 个 合适 的 提供 者 。 

总 的 来 说 , 通常 人 们 应 该 考虑 不 把 所 使 用 的 类 型 作为 服务 , 而 将 能 够 返回 要 使 用 的 实例 的 工 
厂 作为 服务 。 这 样 的 工厂 应 该 不 依赖 自己 的 状态 ,以 便 正常 工作 (如果 你 的 用 例 与 之 相关 ，, 这 也 
更 容易 实现 线程 安全 )。 工 厂 能 够 将 人 们 想 使 用 的 类 型 的 原始 需求 与 服务 基础 设施 的 特定 需求 区 
分 开 来 ， 而 不 需要 将 它们 混淆 为 同一 个 类 型 。 


10.3.3 ”从 全 局 状态 中 隔离 消费 者 


调用 serviceLoader: :load 的 代码 很 难 测试 ， 因 为 它 依赖 于 全 局 的 应 用 程序 状态 ， 即 项 
目 启动 时 加 载 了 哪些 模块 。 当 使 用 服务 的 模块 不 依赖 于 提供 服务 的 模块 (通常 如 此 ) 时 ， 这 很 容 
易 成 为 一 个 问题 ， 因 为 接 下 来 ,构建 工具 在 测试 的 模块 路 径 中 不 会 包含 提供 服务 的 模块 。 

为 单元 测试 手动 准备 ServiceLoader 以 返回 一 个 特定 的 服务 提供 者 列表 , 这 需要 做 很 多 工 
作 。 对 单元 测试 来 说 , 这 很 不 友好 , 因为 单元 测试 应 该 可 以 独立 运行 并 且 仅 调用 很 小 的 代码 单元 。 

除 此 之 外 ， 针 对 serviceLoader: :1oag 的 调用 通常 不 会 解决 应 用 程序 使 用 者 所 关心 的 任 
何 问题 ,只 是 针对 这 种 方案 的 一 项 必要 的 技术 手段 。 这 使 得 它 相 较 于 服务 提供 者 的 代码 而 言 , 成 
了 一 种 不 同 级 别 的 抽象 。 单一 职责 原则 的 拥护 者 们 会 指出 ,这样 包含 了 两 个 职责 ( 请求 服务 提供 
者 以 及 实现 业务 需求 ) 的 代码 似乎 太 多 了 。 

这 些 属性 建议 , 处 理 服 务 加 载 的 代码 不 应 该 与 实现 应 用 程序 业务 需求 的 代码 混在 一 起 。 幸 好 ， 
让 它们 保持 独立 不 是 一 件 复杂 的 事情 。 最 终 使 用 服务 提供 者 的 实例 在 某 处 得 到 了 创建 ,而 这 通常 
是 一 个 调用 serviceLoader 并 且 传递 服务 提供 者 的 好 地 方 。ServiceMonitor 也 是 同样 的 结构 : 
为 了 在 主 类 中 运行 应 用 程序 (包括 加 载 ServiceOobserver 的 实现 ) 而 创建 了 所 有 需要 的 实例 ， 
然后 将 它们 传递 给 Monitor， 由 Monitor 完成 监控 服务 的 实际 工作 。 
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代码 清单 10-4 和 代码 清单 10-5 展示 了 一 种 对 比 。 在 代码 清单 10-4 中 , Integerstore 自己 
实现 了 繁重 的 服务 任务 , 将 两 个 职责 混在 一 起 。 这 也 使 得 使 用 Integerstore 的 代码 很 难 测试 ， 
因为 相关 测试 需要 了 解 对 serviceLoader 的 调用 ， 并且 确保 它 能 够 返回 期 望 的 整数 创建 者 。 

在 代码 清单 10-5 中 ，Integerstore 得 到 了 重 构 ， 并 且 期 望 构 造 它 的 代码 能 够 返回 
List<IntegerMaker>。 这 使 得 自身 的 代码 可 以 聚焦 于 所 关注 的 业务 ( 创建 整数 )， 并 且 移 除了 
所 有 对 ServiceLoader 以 及 全 局 应 用 程序 状态 的 依赖 。 这样 一 来 ,相应 的 测试 就 变 成 轻而易举 


的 事情 了 。 有 时 人 们 仍然 需要 处 理 服务 加 载 ， 但 是 在 应 用 程序 设置 过 程 中 调用 create.. .方法 
才 是 更 正确 的 做 法 。 


代码 清单 10-4 ”由 于 职责 太 多 而 不 易 测试 


public class Integers { 
































IntegerStore store new IntegerStore(); 
List<Integer> ints store.makeIntegers (args[0]); 
System.out .println(ints); 


public static void main(String[] args) { 


} 这 个 调用 的 结果 直接 依赖 
于 模块 路 径 的 内 容 , 使 得 它 
public class IntegerStore { 很 难 进行 单元 测试 





public List<Integer> makeIntegers (String config) { 
return ServiceLoader 


.load (IntegerMaker.class) .stream() 


解决 了 加 载 整数 制 
.map (Provider: :get) 造 者 的 技术 需求 
.map (maker -> maker.make (config)) 
> 解决 了 业务 问题 : 制造 唯 
一 的 囊 十 号 从 
oT ob (Lea) 的 整数 并 对 它们 排序 


} 
public interface IntegerMaker { 
int make (String config); 
} 
代码 清单 10-5 ” 重 写 以 改进 设计 和 可 测试 性 
public class Integers { 
public static void main(String[] args) { 
IntegerStore store createIntegerStore(); 


( 
List<Integer> ints = store.makeIntegers (args[0]); 
System.out .println(ints); 
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private static IntegerStore createIntegerStore() { 
List<IntegerMaker> makers = ServiceLoader 


.load (IntegerMaker.class) .stream() 
.map (Provider: :get) 解决 了 在 设置 过 程 中 加 载 


.Collect (toList()); 整数 制造 者 的 技术 需求 


return new IntederStore (makers) 


} 
public class IntegerStore { 
private final List<IntegerMaker> makers; 
IntegerStore 在 构造 过 程 中 得 到 了 
public IntegerStore(List<IntegerMaker> makers) { 制造 者 ， 并 且 对 serviceLoader 没 
this.makers = makers; 有 依赖 
} 


public List<Integer> makeIntegers (String config) { 
return makers.stream!() makeIntegers 方法 可 以 


.map (maker -> maker.make (config)) 聚焦 于 它 的 业务 需求 
.distinct() 
.Sorted() 


.Collect (toList()); 


} 
public interface IntegerMaker { 
int make(String config); 
} 
根据 特定 的 项 目 和 需求 , 你 也 许 不 得 不 将 服务 提供 者 传递 给 多 个 方法 或 构造 函数 , 并 将 它 包 


囊 进 另 一 个 对 象 , 直到 最 后 一 刻 才 加 载 ， 或 者 配置 你 的 依赖 注入 框架 , 但 它 应 该 可 行 。 这 种 努力 
是 值得 的 一 一 你 的 单元 测试 和 同事 都 将 从 中 受益 。 


10.3.4 ”将 服务 、 消 费 者 和 提供 者 组 织 成 模块 


随 着 服务 的 类 型 、 设 计 以 及 消费 都 确定 下 来 ,问题 就 浮现 了 出 来 : 你 如 何 将 服务 以 及 另外 两 
个 参与 者 ， 即 消费 者 和 提供 者 ， 组 织 到 模块 中 ?显而易见 ， 服务 需 要 被 实现 ， 并 日 为 了 让 它 有 价 
值 ， 提 供 服 务 的 模块 之 外 的 其 他 模块 应 该 可 以 实现 这 个 服务 。 这 意味 着 服务 类 型 必须 是 公有 的 ， 
并 且 在 一 个 已 导出 的 包 中 。 

消费 者 没 必 要 是 公有 或 者 导出 的 , 因此 可 以 是 其 模块 内 部 的 。 它 必须 访问 服务 类 型 ， 所 以 需 
要 依赖 于 包含 服务 ( 服务 , 而 不 是 实现 它 的 类 ) 的 模块 。 消费 者 和 服务 在 同一 个 模块 中 并 不 罕见 ， 
正如 java.sql] 和 Driver 以 及 java.base 和 LoggerFinder。 

最 后 来 看 提供 者 。 由 于 提供 者 实现 了 服务 , 因此 它 就 不 得 不 读 取 定义 服务 的 模块 一 一 这 很 明 
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显 。 一 个 有 趣 的 问题 是 ， 除 了 被 proviges 指令 命名 ， 提 供 者 类 型 是 否 应 该 属于 模块 公有 API 的 
一 部 分 ? 
服务 提供 者 必须 是 公有 的 ， 但 是 技术 上 并 不 需要 将 所 在 的 包 导 出 一 一 实例 化 不 可 访问 的 类 ， 
对 于 服务 加 载 器 来 说 是 没有 问题 的 。 这 样 ， 将 含有 提供 者 的 包 导 出 ， 会 不 必要 地 扩大 模块 API 
的 范围 。 它 也 会 让 消费 者 做 一 些 多 余 的 事情 ， 比 如 将 某 个 服务 强制 转换 为 它 的 真实 类 型 ， 以 访问 
一 些 额 外 的 功能 ( 与 发 生 在 URLClassLoader 上 的 事情 类 似 ， 参 见 6.2.1 节 )。 因 此 本 书 建议 不 
要 使 服务 提供 者 可 受 访问 。 
总 的 来 说 ， 有 如 下 几 点 〈 如 图 10-9 所 示 )。 
口 服务 是 公有 的 ， 且 所 在 的 包 被 导出 。 
口 消费 者 可 以 是 内 部 的 ， 它 们 需要 读 取 定 义 服务 的 模块 ， 甚 至 属于 这 个 模块 。 
口 提供 者 必须 是 公有 的 ,但 是 不 应 该 在 导出 的 包 中 ， 这 样 可 以 减少 误 用 、 缩 小 API 范围 ， 
它们 需要 读 取 定义 服务 的 模块 。 
























































| i 需要 是 可 访问 的 : 需要 是 公有 的 ， 
可 见 性 和 可 访问 性 不 重要 公有 的 和 导出 的 但 不 是 导出 的 
或 许 存 在 于 同一 个 模块 中 ) 
| 


USes provides 
Consumer Service Provider 


1 
1 
_/ 


图 10-9 ”消费 者 、 服 务 和 提供 者 的 可 见 性 和 可 访问 性 需求 


2 








注意 一 个 模块 只 能 通过 它 所 拥有 的 类 型 提供 服务 。provides 指令 命名 的 服务 实现 必 
须 与 服务 声明 在 同一 个 模块 中 。 


10.3.5 ”使 用 服务 打破 循环 依赖 


当 在 被 分 成 几 个 子 项 目的 代码 库 中 工作 时 , 总 是 会 有 这 样 的 情况 发 生 : 其 中 一 个 子 项 目 变 得 
太 大 ,因此 人 们 想 将 它 拆 分 成 更 小 的 项 目 。 这 需要 一 些 额 外 的 工作 , 但 是 如 果 有 足够 的 时 间 来 整 
理 其 中 的 类 ,通常 人 们 是 可 以 完成 这 个 目标 的 ,但 是 有 时 候 代码 会 混在 一 起 ， 无 法 分 开 。 

一 个 常见 原因 是 类 之 间 的 循环 依赖 。 它 可 以 是 两 个 类 互相 导入 , 也 可 以 是 一 个 更 长 的 包含 多 
个 类 的 循环 ， 其 中 每 一 个 类 都 导入 下 一 个 。 然 而 ， 如 果 人 们 和 希望 它 的 一 部 分 在 一 个 项 目 中 ， 而 其 
他 部 分 在 另 一 个 项 目 中 ， 就 会 出 现 问题 。 即 便 没 有 模块 系统 ， 问 题 依 然 存在 ， 因 为 构建 工具 通常 
也 不 喜欢 循环 依赖 ,但 是 JPMS 在 这 一 点 上 与 其 他 工具 有 很 大 的 分 收 。 


注意 根据 可 访问 性 规则 , 属于 不 同 模 块 的 类 之 间 的 依赖 , 需要 以 这 些 模 块 间 的 依赖 为 
前 提 (参见 3.3 节 )。 如 果 类 依赖 存在 循环 ， 那 模块 依赖 也 一 样 存在 循环 ， 但 是 可 读 性 
规则 不 允许 出 现 这 样 的 情况 (参见 3.2 六 。 
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怎么 办 呢 ? 因为 本 章 的 主要 内 容 是 服务 , 所 以 服务 可 以 解决 这 个 问题 并 不 令 人 惊奇 。 解 决 方 
图 10-10 





安 


案 是 通过 在 依赖 模块 中 创建 服务 来 实现 循环 中 
所 示 )。 











迁 念 上 的 依赖 ， 而 不 是 
依赖， 因为 JPMS 
秆 环 依赖 





禁止 和 


~ 








depended 












depending 





































[ 大 下 ) 
depend on 
你 选择 将 这 对 依赖 关系 反 转 
3 
在 depending 中 ， 
并 e 人 代替 Tvpe， 
并 且 移 除 depending 
到 depended 的 依赖 depended 
‘ee 





depending 


module depending { 
uses Service; 


Service 














图 10-10 


带 


i 


( 
此 处 将 重点 关注 该 特殊 场景 一 一 如 果 有 更 多 的 
(2) 在 depending 中 ， 创 建 一 个 服务 类 型 ， 








(3) 在 depending 中 , 移 除 对 depended 的 依赖 ,将 因此 导致 的 编译 错误 记录 下 来 ,因为 depended 
的 类 型 不 再 可 访问 。 将 所 有 的 引用 替换 为 对 应 服务 的 





使 用 服务 打破 循环 依赖 的 4 个 步 又 : 
服务 ; 名 在 依赖 端 使 用 该 服务 ; 


(1) 检查 模块 依赖 中 的 循环 ,将 想 要 反 转 的 依赖 标识 出 来 。 两 个 相关 的 模块 被 称 为 depending 
有 requires 指令 的 模块 ) 和 depended。 理想 情况 下 ，depending 使 用 depend 中 的 单个 类 型 。 





的 一 个 依赖 反 转 。 以 下 是 实现 步骤 解析 ( 如 





2 
设计 一 个 基于 depended 
的 服务 ， 然 后 把 它 加 到 
depending 中 





depended 


depending "| 


module depending { 
uses Service; 
5 

















4 
让 Type 实 现 Service 


并 且 向 外 提供 daneed 

module depended { 
requires depending; 
provides Service 

with Type; 










> 









implemenis 





depending 


module depending { 
uses Service; 
] 









添加 从 depended 到 
depending 的 依赖 关系 ; 
所 以 对 depended 而 言 ， 
Service 是 可 访问 的 。 
于 是 现在 依赖 关系 被 反 转 了 


9 选择 一 对 依赖 关系 ; 
4 在 被 依赖 端 提供 服务 














2 在 依赖 端 引入 


类 型 ， 每 个 类 型 都 会 重复 后 面 的 步 又。 


使 用 uses 指令 为 这 个 类 型 扩展 模块 声明 。 








类 型 ， 


需要 进行 以 下 操作 。 
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@ 更 新 导 和 人 和 类 名 。 
@ 方法 调用 应 该 不 需要 任何 改动 。 
和 构造 水 数 调用 并 非 开 箱 即 用 , 因为 你 需要 来 自 depended 的 实例 。 这 就 是 ServiceLoader 
的 介入 点 : 通过 加 载 刚刚 创建 的 服务 类 型 来 蔡 换 depended 类 型 的 构造 函数 。 
(4) 在 depended 中 ， 增 加 一 个 到 depending 的 依赖 ， 这 样 服务 类 型 就 变 成 了 可 访问 的 。 用 这 个 

经 造成 麻烦 的 类 型 提供 服务 。 

成 功 了 ! 你 将 depending 和 depended ( 现在 后 者 依赖 于 前 者 ) 之 间 的 依赖 反 转 了 ， 进 而 打破 

了 循环 依赖 。 以 下 是 需要 进一步 了 解 的 细节 。 

口 depending 所 使 用 的 depended 中 的 类 型 也 许 不 是 一 个 理想 的 服务 候选 类 型 。 如 果 确 实 是 这 

样 ， 可 以 考虑 为 它 创建 一 个 工厂 (参见 10.3.2 节 )， 或 者 寻找 另 一 个 可 以 替换 的 依赖 。 

口 10.3.3 节 探 索 了 将 ServiceLoader 调用 散落 在 整个 模块 中 带 来 的 问题 , 这 个 问题 与 依赖 

反 转 相关 。 也 许 你 需要 重 构 depending 的 代码 ， 以 实现 最 小 化 服务 加 载 数 量 。 

口 服务 类 型 并 非 一 定 要 在 depending 中 。 如 10.3.4 节 所 述 ， 服 务 类 型 可 以 在 任何 模块 中 , 或 
者 更 确切 地 说 ， 几 乎 可 以 在 所 有 模块 中 ， 所 以 你 肯定 不 愿意 将 其 放 在 会 产生 循环 依赖 的 
模块 ( 比如 depended ) 中 。 

口 最 重要 的 是 ， 应 该 尝试 创建 一 个 独立 存在 的 服务 ， 而 不 仅仅 是 循环 依赖 的 “破坏 者 ”， 
为 现实 中 可 能 会 有 更 多 的 服务 提供 者 和 消费 者 ， 而 不 仅仅 是 本 节 中 所 讨论 的 两 个 模块 。 


10.3.6 ”在 不 同 的 Java 版 本 中 声明 服务 


服务 不 是 新 鲜 事物 ，Java 6 就 已 经 引入 了 服务 ， 且 当时 设计 的 机 制 至 今 仍 然 有 效 。 在 没有 模 
块 的 情况 下 观察 服务 的 工作 方式 ， 尤 其 是 它 在 普通 JAR 和 模块 化 JAR 之 间 如 何 工作 ， 是 非常 有 
意义 的 。 










































































1. 在 META-INF/services 中 声明 服务 

在 模块 系统 诞生 之 前 ,服务 的 工作 原理 与 现在 相同 ， 唯 一 的 区 别 是 , 那 时 没有 声明 一 个 JAR 
使 用 或 提供 了 服务 的 模块 声明 。 在 使 用 方面 , 这 没 问 题 一 一 所 有 代码 都 可 以 使 用 它 想 要 的 每 个 服 
务 ; 但 是 在 服务 提供 方面 ，JAR 必须 声明 其 意图 ， 并 且 必 须 在 JAR 的 专用 目录 中 放置 该 声明 。 

要 使 普通 JAR 声明 一 个 服务 ， 请 遵循 以 下 简单 步骤 。 

(1) 在 META-INF/services 目录 中 ， 放 置 一 个 以 该 服务 的 完全 限定 名 称 作为 文件 名 的 文件 。 

(2) 在 该 文件 中 ， 列 出 实现 该 服务 的 所 有 完全 限定 名 称 的 类 。 

作为 示例 , 创建 一 个 第 三 方 的 ServiceObserverFactory 服务 提供 者 , 它 位 于 新 假设 的 普 
通 JAR monitor.observer.zero 中 。 要 做 到 这 一 点 ， 首 先 需 要 一 个 具体 类 ZeroserviceObserver- 
Factory 来 实现 ServiceObserverFactory 并 提供 无 参 构 造 孙 数 。 这 类 似 于 alpha 和 beta 的 
变 体 ， 此 处 不 再 详细 讨论 。 

普通 JAR 并 没有 声明 所 提供 服务 的 模块 描述 符 ， 但 是 你 可 以 使 用 META-INF/services 目录 : 
在 该 目录 中 新 建 一 个 简单 的 文本 文件 并 将 其 命名 为 monitor.observer.ServiceObserverFactory( 服务 
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类 型 的 完全 限定 名 称 ), 文件 中 仅 有 一 行内 容 , 即 monitor observer.zero.ZeroServiceObserverFactory 
( 服务 提供 类 型 的 完全 限定 名 称 )。 图 10-11 展示 了 这 些 操作 结果 。 


文件 内 容 : 


目 monitor.observer.ServiceObserverFactory 





monitor.observer.zero.jar 
国 META-INF 
国 services 
目 monitor.observer.ServiceObserverFactory 
目 MANIFEST.MF 
国 monitor 
国 observer 
国 zero 


目 ZeroServiceObserverFactory.class 











monitor.observer.zero.ZeroServiceObserverFactory 











目 ZeroServiceObserver.class 


图 10-11 为 了 不 通过 模块 声明 来 声明 服务 提供 者 , META-INF/services 
带 有 服务 名 称 的 纯 文 本 文件 ， 其 中 每 一 行 一 个 提供 者 信息 


这 样 做 是 可 行 的 ， 并 有 日 Main 困 数 在 处 理 所 有 observer 工厂 时 ,ZeroServiceObserver- 
Factory 可 以 得 到 正确 解析 。 但 是 其 中 的 细节 需要 等 到 讨论 普通 JAR 和 模块 化 JAR 如 何 交 互 时 
才能 揭晓 。 这 是 之 后 的 话题 。 


注意 在 META-INF/services 中 声明 服务 和 在 模块 声明 中 这 么 做 有 一 个 微小 的 区 别 : 只 
有 后 者 可 以 使 用 提供 者 中 的 函数 ; 前 者 只 能 使 用 公有 的 无 参 构造 函数 。 














录 中 需要 包含 




































































2. JAR 和 路 径 间 的 兼容 性 

因为 服务 加 载 器 API 在 Java 9 的 模块 系统 诞生 之 前 就 已 经 存在 , 所 以 人 们 对 它 有 一 些 兼 容 性 
方面 的 顾虑 。 普 通 JAR 和 模块 化 JAR 中 的 消费 者 能 否 以 相同 方式 使 用 服务 ? 在 多 种 JAR 和 路 径 
同时 使 用 时 ， 提 供 者 是 否 可 以 正常 工作 ? 

对 于 服务 消费 者 而 言 ， 情 况 很 简单 : 清晰 模块 可 以 通过 uses 指令 声明 来 使 用 服务 ; 自动 模 
块 (参见 8.3 节 ) 和 无 名 模块 (参见 8.2 节 ) 可 以 使 用 所 有 现 有 的 服务 。 总 之 在 消费 者 方面 ， 这 
些 都 是 可 行 的 。 

对 于 服务 提供 者 而 言 ， 情 况 有 些 复杂 。 这 里 有 两 个 坐标 轴 ， 每 个 轴 有 两 个 变量 ， 因 此 一 共有 
4 种 组 合 。 
口 JAR 的 类 型 : 普通 JAR (在 META-INF/services 中 声明 的 服务 ) 或 模块 化 JAR (在 模块 描 
述 符 中 声明 的 服务 )。 
口 路 径 的 类 型 : 类 路 径 或 模块 路 径 。 

无 论 普 通 JAR 最 终 指 向 哪个 路 径 ,服务 加 载 器 都 将 在 META-INF/services 中 标识 并 绑 定 服务 。 
如 果 JAR 位 于 类 路 径 上 ， 则 其 内 容 已 经 是 无 名 模块 的 一 部 分 ; 如 果 JAR 位 于 模块 路 径 上 ， 则 服 
务 绑 定 将 导致 创建 自动 模块 。 如 8.3.2 节 所 述 ， 这 将 触发 所 有 其 他 自动 模块 的 解析 。 
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现在 你 知道 为 什么 可 以 在 模块 化 的 应 用 程序 ServiceMonitor 中 使 用 monitorobserver.zero ， 即 
一 个 在 META-INF/services 中 提供 服务 的 普通 JAR 了 吧 。 选 择 哪 个 路 径 没 有 关系 ,两 者 都 可 以 直 
接 正 常 工 作 。 


要 点 ”模块 路 径 上 的 模块 化 JAR 是 在 模块 系统 中 实践 服务 的 最 佳 选 择 , 因此 它们 
可 以 不 受 限制 地 工作 。 但是， 在 类 路 径 上 ， 模 块 化 JAR 可 能 会 引起 问题 。 它 们 被 
视 为 普通 JAR， 因 此 在 META-INF/services 目录 中 需要 有 对 应 的 文件 。 作 为 一 名 
开发 人 员 ， 如 果 你 的 项 目 依 赖 于 服务 ， 并 且 期 望 模块 化 工件 在 两 个 路 径 上 都 可 以 
工作 ， 那 么 你 需要 在 模块 描述 符 以 及 META-INEF/services 中 声明 服务 。 


从 类 路 径 启 动 ServiceMonitor 不 会 产生 任何 有 用 的 输出 ， 因 为 它 找 不 到 任何 observer 工厂 一 一 
除非 你 将 monitor.observer.zero 添加 进去 。 和 凭借 META-INF/services 中 的 提供 者 定义 ， 它 将 非常 适 
合同 无 名 模块 一 起 工作 (这 种 情况 与 alpha 和 beta 提供 者 不 同 )。 











10.4 使 用 ServiceLoader API 访问 服务 


尽管 serviceLoader 自 Java 6 就 已 经 存在 , 但 尚未 得 到 广泛 采用 。 本 书 希 望 通过 将 它 与 模 
块 系统 进行 紧密 集成 , 显著 提高 其 使 用 频率 。 为 了 确保 大 家 了 解 其 API 的 使 用 方法 ,本 节 将 进行 

像 往常 一 样 ， 第 一 步 是 了 解 基础 知识 ， 这 不 会 花 很 长 时 间 。 但 是 ， 服 务 加 载 器 确实 有 一 些 特 
性 ， 为 了 确保 这 些 特性 不 会 成 为 绊脚石 ， 本 节 也 将 就 此 进行 讨论 。 


10.4.1 ”加 载 和 访问 服务 


使 用 serviceLoagder 始终 是 一 个 两 步 的 过 程 。 

(1) 为 正确 的 服务 创建 一 个 serviceLoaqer 实例 。 

(2) 使 用 该 实例 访问 服务 提供 者 。 

快速 浏览 每 个 步 又 ,以便 了 解 各 种 选项 。 同 时 查看 表 10-1, 以 对 serviceLoader 的 所 有 方 
法 有 统一 的 了 解 。 









































表 10-1 ServiceLoaderAPI 总 览 












































返回 类 型 方法 名 称 描 述 
为 给 定 类 型 创建 新 服务 加 载 器 的 方法 

ServiceLoader<S> load(Class<S>) 从 当前 线程 的 上 下 文 类 加 载 将 中 开始 加 载 提供 者 

ServiceLoader<S> load(Class<S>, 从 指定 的 类 加 载 器 中 开始 力 上 载 提 供 者 
ClassLoader) 

ServiceLoader<S> load (ModuleLayer, 从 指定 模块 层 中 的 模块 里 开始 加 载 提 供 者 
Class<S>) 

ServiceLoader<S> loadIinstalled(Class<S>) 从 平台 类 加 载 器 中 加 载 提 供 者 
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( 续 ) 
返回 类 型 方法 名 称 描 述 
访问 服务 提供 者 的 方法 
Optional<S> findFirst() 加 载 第 一 个 可 用 的 提供 者 
Iterator<s> iterator() 返回 一 个 迭代 器 ， 用 于 延迟 加 载 和 实例 化 可 用 的 
提供 者 
Stream<Provider<S>> stream() 返回 一 个 流 ， 用 于 延迟 加 载 可 用 的 提供 者 
void reload() 清空 当前 加 载 器 的 提供 者 缓存 ， 以 便 重新 加 载 所 





























有 的 提供 者 


1. 创建 serviceLoade 的 方式 
第 一 步 , 创建 一 个 ServiceLoader 实例 ， 这 可 以 通过 它 的 一 些 静 态 1oad 方法 来 实现 。 最 简 
单 的 方式 是 ， 只 需要 加 载 服务 的 class<s> 实 例 [ 这 被 称 为 类 型 令 牌 (type token )， 即 本 例 中 的 s ]。 


ServiceLoader<TheService> loader = ServiceLoader.load(TheService.class); 


如 果 需 要 处 理 数 个 类 加 载 器 或 模块 层 (参见 12.4 节 )， 则 只 需 考虑 其 他 10ad 方法 。 这 种 情 
况 并 不 常见 ， 所 以 对 此 不 再 讨论 。 如 果 有 需要 ， 请 参考 API 文 档 。 

另 一 种 获得 服务 加 载 器 的 方式 是 lo0adInstalled。 这 很 有 趣 ， 因 为 它 具 有 特定 的 行为 方式 : 
忽略 模块 路 径 和 类 路 径 , 仅 从 平台 模块 加 载 服务 , 这 意味 着 它 仅 返 回 JDK 模块 中 所 能 找到 的 提供 者 。 


2. 访问 服务 提供 者 

有 了 针对 所 需 服务 的 ServiceLoader 实例 ,是 时 候 开 始 使 用 这 些 提供 者 了 。 有 两 种 半 方 法 
可 以 做 到 这 一 点 。 
D Iterator<S> iterator() 人 允许 你 遍历 实例 化 的 服务 提供 者 。 
口 Optional<S> findFirst() 使 用 iterator 迭代 并 返回 第 一 个 提供 者 ( 如果 有 提供 者 
被 发 现 的 话 )。 这 是 一 种 简易 方法 ， 所 以 作为 特殊 的 半 种 方法 。 
口 Stream<Provider<S>> stream() 允许 你 对 服务 提供 者 进行 流 式 访问 ， 并 且 这 些 提 供 

者 已 包装 在 Provigder 实例 中 ( 想 深 入 了 解 这 是 怎么 回 事 ? 参见 10.4.2 愧 。 

如 果 你 有 特定 的 延迟 或 缓存 需求 ( 更 多 信息 参见 10.4.2 节 )， 则 可 能 想 要 保留 ServiceLoader 
实例 。 但 是 在 大 多 数 情 况 下 ， 这 不 是 必需 的 ， 你 可 以 立即 遍历 提供 者 或 对 其 进行 流 式 处 理 。 

ServiceLoader 

.load (TheService.class) 


.iterator() 
.forEachRemaining (TheService: :doTheServiceThing); 








































































































(类 型 为 8s 的) iterator 和 (类 型 为 Provider<S> 的 ) stream 之 间 的 不 一 致 是 有 历史 原 
因 的 。 尽 管 从 Java 6 开始 就 有 了 iterator, 但 直到 Java 9，stream 和 Provider 才 加 入 。 

尽管 明显 但 仍然 容易 忽略 的 一 个 细节 是 , 某 个 给 定 的 服务 可 能 没有 对 应 的 提供 者 。 Iterator 
和 stream 可 能 为 室 ，finqFirst 也 可 能 返回 空 的 Optional。 如 果 采 用 特定 过 滤 方 式 (参见 
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10.3.2 节 和 10.4.2 节 )， 则 有 很 大 概率 最 终 没有 合适 的 提供 者 。 

所 以 请 确保 代码 可 以 正常 处 理 这 种 情况 ， 并 且 可 以 在 没有 服务 的 情况 下 运行 (或 者 快速 失 
败 )。 如果 应 用 程序 忽略 了 一 个 很 容易 检测 到 的 错误 , 然后 在 不 确定 和 不 理想 的 状态 下 持续 运行 ， 
这 是 很 烦人 的 。 


10.4.2 ”服务 加 载 的 特性 


虽然 ServiceLoader API 非常 简单 ， 但 是 也 要 小 心 ， 其 幕后 发 生 了 一 些 重要 的 事情 ， 在 使 
用 这 些 API 满足 各 种 需求 〈 而 非 简单 的 “Hello, services!”) 时 ， 必 须要 了 解 它 们 。 你 需要 了 解 服 
务 加 载 器 的 延迟 性 、 它 是 否 具备 并 发 能 力 ， 以 及 适当 的 错误 处 理 方 法 。 下 文 将 逐一 进行 讲解 。 


1. 延迟 加 载 和 选择 正确 的 提供 者 
让 服务 加 载 需 尽 可 能 延迟 加 载 。 调 用 serviceLoader<s> (其 中 s 是 ServiceLoader:: 
1oad 调用 的 服务 类 型 )， 其 iterato 方法 会 返回 Iterator<S>， 并 且 仅 在 调用 hasNext 或 
next 时 查找 并 实例 化 下 一 个 提供 者 。 
stream 方法 更 具有 延迟 性 。 它 返回 的 Stream<Proviader<S>> 不 仅 在 找到 提供 者 (如 
iterator ) 方面 延迟 ， 而 且 返 回 的 还 是 Proviger 实例 ， 这 进一步 延 民 了 服务 的 实例 化 : 直到 
get 方法 受到 调用 , 实例 化 才 完 成 。 它 们 的 type 方法 允许 特定 的 提供 者 访问 Class<? extends 
S> 实 例 ( 意味 着 实现 该 服务 的 类 型 ， 而 不 是 该 服务 类 型 )。 
访问 提供 者 的 类 型 对 于 扫描 注解 ( 而 没有 类 的 实际 实例 ) 的 情况 很 有 用 。 与 10.3.2 节 末 尾 讨 
论 的 内 容 类 似 , 它 为 你 提供 了 一 种 工具 ， 可 以 为 给 定 的 配置 选择 正确 的 服务 提供 者 , 但 不 必 先 实 
例 化 它 实例 化 会 造成 一 定 的 性 能 影响 )。 前 提 是 该 类 带 有 能 够 表明 提供 者 适用 性 的 注解 。 
继续 讨论 ServiceMonitor 的 例子 ，serviceobservet 工厂 适用 于 特定 REST 服务 的 多 种 实 
现 ， 该 工厂 可 以 加 上 ealpha 注解 或 eBeta 注解 ， 表 明 其 具体 实现 。 
Optional<ServiceObserverFactory> alphaFactory = ServiceLoader 
.load (ServiceObserverFactory.class) .stream() 
.filter (provider -> provider.type().isAnnotationpresent (Alpha.class)) 


.map (Provider: :get) 
.findFirst(); 

























































































在 这 里 ，Provider: :type 可 以 用 于 访问 class<? extends ServiceObserver>， 然后 
它 会 经 过 isAnnotationPresent， 判 断 是 否 带 有 注解 eaAlpha。 只 有 在 调用 Provider::get 
时 ， 该 工厂 才 被 实例 化 。 

为 了 让 延迟 加 载 更 加 完美 ，serviceLoader 实例 会 缓存 到 目前 为 止 已 加 载 的 提供 者 ， 并 始 
终 返 回 相 同 的 提供 者 ,尽管 它 确实 有 一 个 reload 方法 用 于 清空 缓存 ,并 在 下 一 次 调用 iterate、 
stream 或 findFirst 时 触发 新 的 实例 化 操作 ， 也 是 如 此 。 


2. 使 用 并 发 的 服务 加 载 器 
ServiceLoader 实例 并 非 是 线程 安全 的 。 如果 多 个 线程 对 同一 组 服务 提供 者 进行 并 行 操作 ， 
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则 每 个 线程 都 需要 进行 相同 的 ServiceLoagder: :1oad 调用 ， 从 而 获得 其 自身 的 ServiceLoader 
实例 ; 或 者 , 人 们 可 以 对 所 有 线程 进行 统一 的 一 次 调用 , 并 将 结果 存在 一 个 线程 安全 的 集合 容器 中 。 


3. 加 载 服务 时 的 异常 处 理 
当 serviceLoader 尝试 查找 或 实例 化 服务 提供 者 时 ， 可 能 出 错 的 情况 有 很 多 。 
D 一 个 提供 者 可 能 无 法 满足 全 部 要 求 。 也 许 它 没有 实现 服务 类 型 ， 也 许 没 有 合适 的 提供 者 
口 提供 者 构造 隐 数 或 方法 可 能 会 抛 出 异常 或 ( 仅 方 法 ) 返回 nul1。 
口 META-INF/services 中 的 文件 可 能 违反 了 格式 的 要 求 ,或 者 由 于 其 他 原因 而 无 法 得 到 处 理 。 
这 些 只 是 显而易见 的 问题 。 
由 于 加 载 是 延迟 完成 的 ， 因 此 loaa 调用 不 会 引发 任何 异常 。 相 反 ， 和 迭代 器 的 hasNext 和 
next 方法 以 及 流 处 理 过 程 和 Provider 方法 都 可 能 引发 错误 。 这 些 错误 都 是 Serviceconfigura- 
tionError 类 型 ， 因 此 捕获 该 错误 可 以 处 理 可 能 发 生 的 所 有 问题 。 


10.5 小结 


口 服务 架构 由 4 个 部 分 组 成 。 
加 服务 (service ) 是 一 个 类 或 者 接口 。 
和 提供 者 〈provider ) 是 一 个 具体 的 服务 实现 。 
@ 消费 者 ( consumer ) 是 希望 使 用 服务 的 任何 一 段 代 码 。 
和 ServiceLoader 为 给 定 服务 的 每 个 提供 者 创建 一 个 实例 ， 并 将 之 返回 给 消费 者 。 
口 对 服务 类 型 的 要 求 和 建议 如 下 。 
@ 尽管 任何 类 或 接口 都 可 以 作为 服务 ， 但 由 于 目标 是 让 消费 者 和 提供 者 拥有 最 大 的 灵活 
性 ， 因 此 建议 使 用 接口 〈 或 至 少 使 用 抽象 类 )。 
昌 服务 的 类 型 必须 是 公有 的 ， 并 且 在 导出 的 包 中 。 这 使 得 它们 成 了 其 模块 的 公有 API 的 
一 部 分 ， 并 且 应 该 进行 适当 的 设计 和 维护 。 
模块 定义 服务 的 声明 中 并 不 包含 将 类 型 标记 为 服务 的 条 目 。 当 消费 者 或 提供 者 使 用 时 ， 
一 个 类 型 成 了 服务 。 
服务 很 少 随机 出 现 ， 它 们 往往 专门 针对 一 些 目的 而 设计 。 请 始终 考虑 让 使 用 的 类 型 是 工 
厂 , 而 不 是 服务 。 这 使 得 搜索 合适 的 实现 以 及 控制 实例 创建 的 时 机 和 状态 变 得 更 加 容易 。 
口 对 提供 者 的 要 求 和 建议 如 下 。 
和 提供 服务 的 模块 需要 访问 服务 类 型 ， 所 以 它们 必须 引用 包含 该 服务 的 模块 。 
昌 创建 服务 提供 者 的 方法 有 两 种 : 一 种 是 实现 服务 类 型 并 具有 提供 者 构造 函数 (一 个 公 
有 无 参 构造 函数 ) 的 具体 类 ; 另 一 种 是 带 有 提供 者 方法 (一 个 公有 有、 静态 、 无 参量 名 
为 provige 的 方法 ) 并 返回 实现 服务 类 型 实例 的 一 个 类 型 。 无 论 哪 种 方式 ， 该 类 型 都 
必须 是 公有 的 ， 但 无 须 导出 包含 它 的 包 。 相 反 ， 本 书 建议 不 要 将 提供 者 类 型 作为 模块 
公有 API 的 一 部 分 。 
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里 如 果 模 块 需要 提供 服务 ， 则 应 在 它 的 模块 描述 符 中 添加 一 条 provigdes ${service} 
with $s {provider} 指 仿 。 

昌 如果 模 块 化 JAR 需要 提供 服务 , 即使 它 在 类 路 径 上 , 也 需要 在 META-INF/services 目录 
中 添加 对 应 的 条 目 。 对 于 每 条 proviaqes sfservice} with ${provider} 指 令 ， 创 
建 一 个 名 为 $ {service} 的 文件 ， 其 中 每 个 ${provider}) 一 行 记录 (涉及 的 每 个 名 称 都 必 
须 是 完全 限定 名 )。 

口 对 消费 者 的 要 求 和 建议 如 下 。 

@ 消费 服务 的 模块 需要 访问 服务 类 型 ， 因 此 它们 必须 引用 包含 该 服务 的 模块 。 但 是 ， 它 
们 不 应 该 引用 提供 该 服务 的 模块 ， 因 为 这 与 使 用 服务 的 初衷 〈 消费 者 和 提供 者 应 该 分 
离 ) 是 相 违 背 的 。 

@ 服务 类 型 和 服务 的 消费 者 位 于 同一 模块 中 是 没有 问题 的 。 

时 任何 代码 都 可 以 消费 服务 ， 而 不 管 其 自身 的 可 访问 性 如 何 ， 但 是 包含 该 代码 的 模块 需 
要 用 uses 指令 声明 所 使 用 的 服务 。 因 此 这 使 模块 系统 能 够 有 效 地 执行 服务 绑 定 , 并 使 
模块 声明 更 加 明确 和 可 读 。 

和 调用 ServiceLoader: :1oad 消费 模块 , 然后 调用 iterate 或 stream 送 代 地 或 流 式 
地 返回 实例 。 很 有 可 能 会 找 不 到 提供 者 ， 所 以 消费 者 必须 妥善 处 理 这 种 情况 。 

和 @ 消费 服务 代码 的 行为 取决 于 全 局 状态 ， 即 模块 图 中 存在 哪些 提供 者 模块 。 这 给 此 类 代 
码 带 来 了 令 人 讨厌 的 特性 ， 如 使 其 难以 进行 测试 。 尝 试 将 服务 加 载 到 设置 代码 中 ， 并 
让 其 以 正确 的 配置 (例如 通过 依赖 注入 框架 ) 创建 对 象 ， 并 始终 允许 常规 提供 者 代码 
将 服务 提供 者 传递 给 消费 类 ( 例如 ， 在 构造 函数 中 )。 

国 服务 加 载 器 会 尽 可 能 地 延迟 实例 化 提供 者 。 它 的 stream 方法 甚至 返回 一 个 stream 
<Provider<S>>,， 其 中 Provider: :type 可 用 于 访问 提供 者 的 Class 实例 。 这 使 人 
们 得 以 检查 类 级 别 的 注解 ， 搜 索 合适 的 提供 者 ， 而 无 须 实例 化 。 

昌 服务 加 载 器 实例 不 是 线程 安全 的 。 如 果 并 发 地 使 用 它们 ， 则 必须 提供 同步 机 制 。 

@ 在 加 载 和 实例 化 提供 者 过 程 中 遇 到 的 所 有 问题 均 以 serviceConfigurationError 
错误 抛 出 。 由 于 加 载 程序 的 延迟 性 ， 在 加 载 期 间 不 会 发 生 这 种 情况 ， 但 是 在 之 后 遇 到 
有 问题 的 提供 者 时 ，iterate 或 stream 方法 会 抛 出 问题 。 所 以 如 果 想 要 处 理 错误 ， 
请 务必 将 与 ServiceLoader 交互 的 整 块 代码 放 入 try 代码 块 中 。 

口 以 下 是 与 模块 解析 相关 的 一 些 知 识 。 

@ 当 模 块 解析 处 理 声 明 要 使 用 服务 的 模块 时 ， 所 有 提供 此 服务 的 模块 都 会 得 到 解析 ， 并 
因此 包含 在 应 用 程序 的 模块 图 中 。 这 被 称 为 服务 绑 定 (servicebinding )， 并 且 是 与 JDK 
中 使 用 的 服务 绑 定 在 一 起 。 这 解释 了 为 什么 在 默认 情况 下 ， 即 使 是 小 型 应 用 程序 也 会 

使 用 很 多 平台 模块 。 
日 男 一 方面 , 命令 行 选项 --1imit-modules 不 进行 服务 绑 定 。 因 此 , 不 是 模块 传递 依赖 的 

服务 提供 者 ， 在 添加 这 个 选项 后 ， 也 不 会 进入 模块 图 ， 并 且 它 们 在 运行 时 不 可 用 。 该 选 

项 可 用 于 排除 服务 , 可 以 选择 与 --add-modules 一 起 使 用 ,将 其 中 的 一 些 服务 添加 回去 。 





















































































































































完善 依赖 关系 和 APIl 








本 章 内 容 

口 处 理 模 块 API 中 的 依赖 

口 在 不 影响 客户 端 调用 的 基础 上 整合 和 重 构 模 块 
口 定义 可 选 依赖 

口 在 缺乏 依赖 的 情况 下 编写 代码 

口 仅 向 特定 的 模块 导出 包 








第 3 章 介 绍 了 requires 和 exports 指令 如 何 成 为 可 读 性 和 可 访问 性 的 基础 。 但 是 ， 这 些 
机 制 是 绝对 严格 的 : 每 个 模块 必须 被 明确 依赖 , 所 有 被 依赖 的 模块 在 应 用 程序 编译 和 运行 期 间 必 
须 存 在 , 并 且 导 出 的 包 必须 允许 所 有 模块 访问 。 这 些 解决 方案 可 以 满足 大 多 数 用 例 , 但 对 于 很 大 
一 部 分 情况 而 言 ， 仍 然 过 于 宽泛 。 

最 明显 的 用 例 是 可 选 依赖 ， 模 块 需要 与 它 一 起 编译 ， 但 在 运行 时 它 并 非 必需 。 例 如 ，Spring 
使 用 Jackson 的 数据 绑 定 ( databind ) 类 库 。 如 果 你 运行 一 个 Spring 应 用 程序 ， 并 且 想 要 将 JSON 
用 作 数 据 传 输 格 式 ， 那 么 可 以 通过 添加 Jackson 工件 来 获得 支持 。 如 果 该 工件 不 存在 ，Spring 仍 
然 可 以 正常 工作 ， 只 是 不 再 支持 JSON。Spring 使 用 Jackson 但 并 不 依赖 它 。 

但 是 , 常规 的 requires 指令 并 不 涵盖 此 用 例 ， 因 为 一 旦 使 用 该 指令 , 就 只 有 依赖 的 模块 存 
在 时 才能 启动 应 用 程序 。 在 某 些 情况 下 ,服务 是 可 能 的 解决 方案 。 但 是 如 果 将 其 用 于 所 有 可 选 依 
赖 的 场景 ， 则 可 能 会 导致 许多 昌 粹 而 复杂 的 实现 。 因 此 , 简单 明了 地 表示 在 运行 时 不 需要 某 依赖 
项 是 一 个 重要 功能 。11.2 节 说 明了 JPMS 将 如 何 实现 这 一 点 。 

模块 系统 的 严格 性 可 能 成 为 障碍 的 另 一 个 用 例 是 随 着 时 间 的 推移 而 重 构 模 块 。 在 任何 规模 适 
中 的 项 目 中 , 体系 结构 都 会 随 着 时 间 而 演进 ， 在 该 过 程 中 ,开发 人 员 会 希望 合并 或 拆 分 模块 。 但 
是 ,依赖 于 旧 模 块 的 代码 又 会 发 生 什么 呢 ? 它们 会 不 会 缺少 功能 ( 如 果 被 拆 分 为 一 个 新 模块 的 话 ) 
甚至 丢失 整个 模块 ( 如 果 被 合并 的 话 ) ? 幸好 ， 模 块 系统 提供 了 一 种 名 为 隐 式 可 读 性 (implied 
readability ) 的 功能 ， 此 功能 可 以 在 此 时 使 用 。 

目前 为 止 ,虽然 人 们 所 了 解 的 requires 和 exports 机 制 提供 了 一 个 相对 简单 的 思维 模型 ， 
但 是 并 没有 提供 适用 于 所 有 场景 的 一 种 巧妙 的 解决 方案 。 本 章 将 研究 那些 特定 场景 下 的 用 例 , 并 
探索 模块 系统 所 能 提供 的 解决 方案 。 
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读 完 本 章 , 你 将 能 够 使 用 更 完善 的 机 制 来 访问 依赖 和 导出 功能 , 并 且 这 将 使 你 能 够 表达 可 选 
依赖 (参见 11.2 节 )、 重 构 模 块 (参见 11.1 节 ) 以 及 在 一 组 定义 的 模块 之 间 共 享 代码 ， 并 使 其 对 
其 他 代码 保持 私有 (参见 11.3 匠 。 


11.1 隐 式 可 读 性 : 传递 依赖 


3.2 节 深入 探讨 了 requires 指令 如 何在 模块 之 间 建 立 依赖 关系 ， 以 及 模块 系统 如 何 使 用 它 
们 来 创建 可 读 边 〈 最终 产生 模块 图 ， 如 3.4.1 节 和 3.4.2 节 所 述 )。3.3 节 展 示 了 可 访问 性 是 基于 这 
些 边 的 ， 当 访问 一 个 类 型 时 ， 访 问 模块 必须 读 取 包含 该 类 型 的 模块 ( 该 类 型 同时 必须 是 公有 的 且 
必须 位 于 已 导出 的 包 中 ,但 这 与 此 无 关 )。 
本 节 将 探讨 另 一 种 使 模块 能 够 访问 其 他 模块 的 方法 。 在 介绍 新 机 制 之 前 , 本 节 将 先 讨论 一 个 
具有 启发 性 的 用 例 , 并 为 最 佳 使 用 方式 制定 一 些 准则 。 到 最 后 你 将 了 解 它 的 强大 功能 ， 以 及 它 如 
何 提供 比 最 初 示例 更 多 的 帮助 。 

请 访问 ServiceMonitor 的 feature-implied-readability 分 支 , 以 获取 与 本 节 相 关 的 代码 。 


11.1.1 公开 模块 的 依赖 


当 涉 及 requires 指令 和 可 访问 性 之 间 的 交互 时 ， 有 一 个 很 值得 观察 的 细节 : requires 指 
令 创建 了 可 读 边 , 但 边 是 可 访问 性 的 先决 条 件 。 人 们 不 禁 想 问 : 是 否 有 某 种 其 他 机 制 可 以 建立 可 
读 性 , 解锁 类 型 的 访问 ?这 不 仅仅 是 理论 上 的 思考 , 还 是 从 实际 角度 出 发 研究 的 场景 ,它们 最 终 
将 合 二 为 一 。 

回 到 ServiceMonitor 应 用 程序 ， 尤 其 是 monitor.observer 和 monitor.observer.alpha 模块 。 假 设 
有 一 个 名 为 monitorpeek 的 新 模块 想 直接 使 用 monitor.observer.alpha 模块 。 它 可 以 不 需要 monitor. 
observer 或 者 上 一 章 中 的 服务 体系 结构 。 能 否 让 monitorpeek 模块 只 需 引 用 monitor.observer.alpha 
模块 就 能 正常 使 用 该 模块 ? 




































































































































































ServiceObserver observer = new AlphaServiceObserver ("some://service/url"); 

DiagnosticDataPoint data = observer.gatherDataFromService(); 

看 起 来 它 需 要 ServiceObserver 和 DiagnosticDataPoint 类 型 。 两 者 都 在 monitorobserver 
模块 中 , 所 以 如 果 monitorpeek 不 引用 monitor.observer 会 发 生 什么 ” 它 将 无 法 访问 这 些 类 型 , 进 
而 导致 编译 错误 。 正 如 3.3.2 节 在 讨论 关于 传递 依赖 的 封装 时 提 到 的 ， 这 就 是 模块 系统 的 特性 。 

不 过 ， 此 时 这 是 一 个 障碍 。 没 有 来 自 monitor.observer 的 类 型 ，monitor.observer.alpha 实际 上 
是 不 可 用 的 ， 每 个 想 要 使 用 它 的 模块 也 必须 读 取 monitor observer ( 如 图 11-1 所 示 )。 那 么 每 个 使 
用 monitor.observer.alpha 的 模块 也 必须 引用 monitor.observer 吗 ? 

这 不 是 一 种 合理 的 解决 方案 。 要 是 有 另 一 种 机 制 可 以 建立 可 读 性 ,解锁 对 类 型 的 访问 , 那 就 
完美 了 。 

这 些 示例 中 发 生 的 事情 很 常见 。 一 个 名 为 exposing 的 模块 依赖 于 另 一 个 模块 exposed， 但 是 
在 其 自己 的 公有 API (定义 参见 3.3 节 ) 中 使 用 了 来 自 exposed 的 类 型 。 在 这 种 情况 下 ， 可 以 说 
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exposing 将 自己 对 于 exposed 的 依赖 公开 给 它 的 用 户 ， 因 为 这 些 用 户 也 需要 依赖 exposed 才能 使 
用 exposing。 


在 它 的 公有 API 中 使 


用 
observer 的 类 型 入 


requires requires 
(sseverapna ( peek observer.alpha 


\ doesn't 

























ele requires requires 
requires 
read 
因为 peek 不 能 读 取 observer， 通过 这 种 方式 ，peek 可 以 
所 以 它 不 能 正确 地 使 用 alpha 使 用 observer.alpha 




















图 11-1 peek 模块 使 用 observeralpha 模块 ， 后 者 在 它 的 公有 API 中 使 用 observer 的 类 型 。 如 果 

peek 不 引用 observer ( 左 )， 就 不 能 读 取 其 类 型 ， 这 使 得 observeralpha 变 得 不 可 用 。 如 果 
使 用 常规 的 requires 指令 , 唯一 的 解决 办 法 就 是 让 peek 也 引用 observer ( 右 ), 但 是 当 
引入 越 来 越 多 的 模块 时 ， 这 一 切 将 变 得 非常 烦琐 


为 了 把 这 件 事情 描述 得 没 那么 复杂 ， 并 确保 你 了 解 图 11-2 中 的 那些 定义 ， 在 描述 所 涉及 的 
模块 时 ， 本 书 将 遵循 以 下 术语 。 
口 对 外 公开 其 依赖 的 模块 ， 被 称 为 exposing。 
口 被 迫 公 开 为 依赖 的 模块 ， 被 称 为 exposed。 
口 依赖 混乱 的 模块 ， 被 称 为 depending。 


在 它 自己 的 公有 API 中 公开 -个 具有 公有 
来 自 exposed 中 的 类 型 API 的 模块 ) 


requires 


必须 能 够 访问 来 自 exposed 中 的 类 型 ， 
以 能 够 使 用 exposing 


图 11-2 exposed 的 依赖 问题 涉及 3 个 模块 : “无 境 的 ”一 一 提供 某 些 类 型 的 模块 ( 右 侧 的 exposed )、 
“有 责任 的 ” 在 其 公有 API 中 使 用 相关 类 型 的 模块 (中间 的 exposing )，Lb 及 “ 受 影 
啊 的 ” 必须 能 够 访问 “无 束 的 ”中 类 型 的 模块 ( 左 侧 的 depending ) 


在 JDK 中 可 以 找到 许多 示例 。 比 如 java.sql 模块 中 包含 一 个 java.sql.sQLxML 类 型 (被 
java.sdl.connection 等 使 用 ), 该 类 型 来 自 于 java.xml 模块 , 并 在 其 自己 的 公有 方法 中 使 用 。 
java.sdl.SQLXML 类 型 是 公有 的 并 且 在 导出 的 包 中 ,， 因 此 它 是 java.sql API 的 一 部 分 。 这 意味 
着 为 了 让 任何 相关 的 依赖 模块 能 够 正确 地 使 用 已 公开 的 java.sql 模块 ， 前 者 必须 能 读 取 被 迫 公 开 
的 java.xml 模块 。 
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11.1.2 ”传递 修饰 符 : 依赖 的 隐 式 可 读 性 


在 上 述 情 况 中 ， 很 明显 exposing 模块 的 开发 人 员 负 责 解 决 此 问题 。 毕 竟 ， 是 他 们 决定 在 
exposed 模块 自己 的 API 中 使 用 类 型 ， 迫 使 依赖 于 它 的 模块 也 必须 读 取 exposed 模块 。 

这 种 情况 的 解决 方案 是 ， 在 exposing 模块 声明 中 使 用 requires transitive 指令 。 如 果 
exposing 声明 了 requires transitive exposed， 那 么 任何 读 取 exposing 的 模块 也 可 以 隐 式 
地 读 取 exposed。 这 一 作用 被 称 为 隐 式 可 读 性 ( implied readability ): 在 读 取 exposing 的 同时 隐 式 
地 读 取 exposed。 图 11-3 展示 了 这 一 指令 。 


















requires requires 













depending 


depending 可 以 读 取 exposing 对 于 exposed 
exposed， 所 以 它 可 的 隐 式 可 读 性 
以 正确 地 使 用 exposing 





11-3” 当 exposing 使 用 requires transitive 指令 以 依赖 exposed 时 ， 那 么 读 取 
exposing 的 同时 也 能 隐 式 地 读 取 exposed。 结 果 是 ,诸如 depending 模块 ( 左 ) 
可 以 读 取 exposed 模块 ， 即 使 它 只 引用 了 exposing 模块 


当 查 看 模块 声明 或 描述 符 时 ， 隐 式 可 读 性 的 使 用 很 明显 。 借 助 在 5.3.1 节 中 学 到 的 技能 ， 可 
以 对 java.sql 进行 研究 ,以 下 代码 清单 11-1 显示 ,针对 java.xml 的 依赖 已 经 被 标记 为 transitive。 


代码 清单 11-1 java.sql 模 块 描述 符 : java.xml 和 java.logging 的 隐 式 可 读 性 
$ java --describe-module java.sql 

java.sql@9.0.4 

exports java.sql 

exports javax.sql 

exports javax.transaction.xa 这 些 指令 表明 ， 读 取 java.sql 

requires java.base mandate 的 模块 也 可 以 读 取 java.xml 

requires java.logging transitive 和 java.logging 

requires java.xml transitive 

uses java.sql.Driver 


可 以 注意 到 ， 针 对 java.logging 的 依赖 项 也 被 标记 为 transitive。 原 因 是 公有 接口 
java.sql.Driver 及 其 方法 Logger getParentLogger ()。java.sql 模 块 的 公有 API 中 公开 了 
来 自 java.logging 的 java.util.logging.Logger 类 型 ， 因 此 java.sql 上 暗示 了 java.logging 的 可 
读 性 。 注 意 ， 虽 然 java --descripe-module 的 输出 将 transitive 放 在 了 最 后 ， 但 是 模块 
声明 期 望 将 其 放 在 requires 和 模块 名 之 间 ( 即 *equires transitive $s{module} )。 

再 回 到 启发 性 的 示例 上 : 如 何 让 monitor.observer.alpha 可 用 ， 并 使 依赖 它 的 模块 不 需要 引用 
monitor.observer, 解决 方案 现在 很 明显 了 一 一 使 用 requires transitive 声明 monitor.observer. 
alpha 对 monitor.observer 的 依赖 。 


YYVYVMYMMYMVYMVYV 
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module monitor .observer .alpha { 
requires transitive monitor.observer; 
exports monitor.observer.alpha; 


} 


3.2.2 市 在 探索 可 靠 配置 和 依赖 缺失 时 ， 发 现 尽管 运行 时 要 求 所 有 的 依赖 项 ( 直接 的 和 间接 
的 ) 都 存在 , 但 是 编译 时 仅 强 制 要 求 直 接 依 赖 存 在 。 这 意味 着 可 以 在 依赖 并 不 存在 的 情况 下 基于 
exposing 编译 模块 。 那 么 现在 ， 隐 式 可 读 性 如 何 融入 其 中 ? 


要 点 “如果 一 个 模块 的 可 读 性 隐 含 于 正在 编译 的 模块 中 ， 则 它 将 被 放 入 “必须 可 
观察 到 ”的 列表 。 这 意味 着 在 基于 exposing 编译 模块 时 ， 每 个 exposing 的 传递 依 
赖 比如 前 面 示例 中 的 exposed 一 一 必须 是 可 观察 的 。 


不 论 你 是 否 使 用 来 自 exposed 的 类 型 ， 都 是 这 样 。 乍 一 听 可 能 有 点 过 于 严格 。 但 是 请 记 住 ， 
在 3.4.1 节 中 ， 模 块 已 经 得 到 解析 ， 并 且 在 代码 编译 之 前 已 经 构建 了 模块 图 。 模 块 图 是 编译 的 基 
础 〈 而 非 编译 是 模块 图 的 基础 )， 基 于 遇 到 的 类 型 对 其 进行 变化 违反 可 靠 配 置 的 目标 。 因 此 ， 模 
块 图 中 必须 始终 包含 传递 依赖 关系 。 





































































































依赖 链 

你 可 能 想 知 道 ,如 果 每 个 requires 指令 都 使 用 了 transitive, 在 依赖 链 中 会 发 生 什 么 。 
较 长 的 路 径 中 会 隐 含 可 读 性 吗 ? 答案 是 会 ,不 论 是 由 于 显 式 依赖 还 是 隐 式 可 读 性 而 读 取 了 公开 
的 模块 ， 都 意味 着 其 依赖 项 的 可 读 性 相同 。 图 11-4 说 明了 transitive 指令 的 传递 性 。 


depending 读 取 exposed.alpha 是 因为 
它 谈 取 exposed， 共 具有 隐 式 可 读 必 


exposing 读 取 exposed.alpha 是 
因为 exposed 隐 式 依赖 于 它 


depending 读 取 exposed 是 因为 
exposing 隐 式 依赖 于 它 













requires 








exposed.alpha 





transitive 


requires 







requires 





exposed.beta 


transitive 







depending 读 取 exposed.beta 是 因 为 它 读 耻 7 


Se cxposing 读 取 cxposed.beta 是 
cxposed， 其 具有 隐 式 可 读 性 | a 


因为 exposed 陷 式 依赖 于 它 








图 11-4 depending 模块 引用 了 exposing, 后 者 对 exposed 隐 式 可 读 ， 于 是 又 对 exposed.alpha 
和 exposed.beta 隐 式 可 读 。 隐 式 可 读 性 是 可 传递 的 ， 所 以 depending 模块 可 以 读 取 
图 中 其 他 所 有 4 个 模块 ， 即 使 它 仅 依 赖 于 其 中 的 1 个 
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11.1.3” 何 时 使 用 隐 式 可 读 性 


如 前 文 所 述 , 隐 式 可 读 性 减少 了 依赖 模块 中 对 显 式 requires 指令 的 需求 。 这 可 能 是 一 件 好 
事 , 但 是 我 想 回 到 以 前 提 到 过 的 一 些 事 情 上 。 隐 式 可 读 性 与 模块 系统 的 一 个 特性 背道而驰 : 3.2.2 
节 中 所 讨论 的 传递 依赖 的 封装 。 因 为 存在 两 个 互 斥 的 需求 (严格 性 与 便利 性 ) 和 两 个 满足 需求 的 
寺 征 ( 工 quires 与 工 quires transitive 其 所 以 必须 认真 权衡 。 

这 种 情况 类 似 于 访问 修饰 符 。 为 了 方便 起 见 , 应 该 将 每 个 类 、 每 个 字段 和 每 个 方法 设 为 公有 。 
但 是 我 们 不 这 样 做 ,因为 知道 减少 公开 内 容 会 减少 不 同 部 分 代码 之 间 的 接触 面 ， 从 而 使 修改 、 蔡 
换 和 复 用 更 加 容易 。 就 像 公 有 类 型 或 成 员 一 样 ,如 果 将 某 个 依赖 公开 为 该 模块 公有 API 的 一 部 分 ， 
那么 客户 端 代码 就 可 能 依赖 于 隐 式 可 读 性 。 这 会 使 得 涉及 的 模块 及 其 依赖 变 得 更 加 复杂 ,因此 不 
应 轻易 使 用 。 


要 点 ”按照 这 个 思路 , 使 用 transitive 指令 应 该 是 一 个 例外 , 并 且 只 能 在 非常 
特殊 的 情况 下 进行 。 到 目前 为 止 ， 本 书 描述 的 最 典型 情况 是 : 如 果 一 个 模块 在 自 
己 的 公有 API 中 使 用 了 另 一 个 模块 的 类 型 (如 3.3 节 所 述 ), 那么 它 应 该 使 用 一 条 
requires transitive 指令 来 定义 针对 后 者 的 隐 式 可 读 性 。 


其 他 用 例 场景 是 模块 的 聚合 、 分 解 和 合并 ，11.1.5 节 将 对 此 进行 详细 讨论 。 在 此 之 前 ， 这 里 
要 探讨 一 个 可 能 需要 使 用 其 他 解决 方案 的 类 似 用 例 。 

到 目前 为 止 ， 本 章 一 直 假设 exposing 模块 不 能 在 没有 exposed 的 情况 下 运行 。 有 趣 的 是 ， 事 
实 并 非 总 是 如 此 。exposing 模块 可 以 基于 exposed 模块 实现 一 些 工具 方法 ， 并 且 仅 在 能 够 使 用 
exposed 模块 的 情况 下 才能 调用 。 

假设 一 个 类 库 uber.lib 提供 了 基于 com.google.common 的 工具 方法 ， 于 是 只 有 Guava 用 户 才 
可 以 使 用 uber.lib。 在 这 种 情况 下 ， 可 选 依赖 是 可 行 解决 方法 ， 参见 11.2 节 。 


11.1.4” 何 时 依赖 隐 式 可 读 性 


前 文 已 经 介绍 过 如 何 借 助 隐 式 可 读 性 让 模块 “传递 "已 公开 依赖 的 可 读 性 , 并 从 编写 exposing 
模块 的 开发 人 员 和 角度 讨论 了 使 用 该 特性 时 的 注意 事项 。 

现在 转换 视角 ， 从 depending 模块 〈 依赖 模块 ) 的 角度 来 看 一 下 。exposed 模块 的 可 读 性 被 
传递 给 该 模块 , 它 应 该 在 多 大 程度 上 依赖 隐 式 可 读 性 的 模块 ? 应 该 在 什么 时 候 直接 依赖 exposed 
模块 ? 

如 前 文 所 述 ， 在 第 一 次 探索 隐 式 可 读 性 时 ，java.sql 公开 了 对 java.logging 的 依赖 。 这 就 引出 
了 一 个 问题 ,使 用 java.sql 的 模块 是 否 也 需要 引用 java.logging? 从 技术 上 讲 ， 这 样 的 声明 不 是 必 
需 的 ， 并 且 可 能 是 多 余 的 。 

在 启发 性 示例 中 也 是 如 此 , 对 于 monitor.peek、monitor.observer 和 monitor.observer.alpha 模块 
来 说 , 在 最 终 的 解决 方案 中 , monitorpeek 使 用 了 来 自 其 他 两 个 模块 的 类 型 , 但 仅 引用 了 monitor. 
observeralpha 模块 ( 隐 式 地 读 取 monitorobserver 模块 ), 它 应 该 明确 地 引用 monitor.observer 模块 
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吗 ? 如 果 不 应 该 ， 是 仅 在 这 个 特殊 示例 中 这 样 ， 还 是 在 任何 情况 下 都 这 样 ? 

为 了 决定 何 时 基于 隐 式 可 读 性 依赖 于 一 个 模块 ， 以 及 何 时 直接 引用 该 模块 ,有 必要 回 到 模块 
系统 的 核心 承诺 之 一 : 可 靠 配置 (参见 3.2.1 节 )。 使 用 requires 指令 可 以 进行 显 式 依赖 ， 这 可 
以 使 代码 更 可 靠 ， 并 且 你 可 以 应 用 这 个 原则 ， 通 过 提出 另 一 个 问题 来 做 出 决定 。 


要 点 “depending 模块 是 否 不 论 exposing 模块 存在 与 否 均 依赖 于 exposed 模块 ? 或 
者 ， 换 和 句 话说 ,假设 depending 模块 不 再 使 用 exposing 模块 ， 那 它 还 需要 exposed 
模块 吗 ? 


口 如 果 答 案 是 否定 的 , 则 在 删除 使 用 exposing 模块 代码 的 同时 也 删除 了 对 于 exposed 模块 的 
依赖 。 可 以 说 exposed 模块 仅 在 depending 模块 和 exposing 模块 之 间 的 边界 上 使 用 。 在 这 
种 情况 下 ， 无 须 明 确 引 用 它 ， 仅 依赖 隐 式 可 读 性 即 可 。 

口 反 过 来 ,如 果 答 案 是 肯定 的 ,那么 exposed 模块 将 不 止 可 以 在 exposing 模块 的 边界 上 使 用 。 
在 这 种 情况 下 ， 需 要 通过 reauires 指令 明确 地 引用 对 应 的 依赖 。 

11-5 以 可 视 化 的 方式 展示 了 这 两 个 选项 。 


depending 仅 在 与 exposing 的 
边界 上 使 用 exposed 


7 
边界 使 用 depending A spoang 


内 部 使 用 exposing 







































































对 于 exposed 模 块 的 使 用 
depending 由 于 自己 内 部 的 
需要 而 使 用 exposed 
图 11-5 隐 式 可 读 性 的 两 种 情况 ,其 中 涉及 了 depending 、exposing 和 exposed 模块 。 图 中 在 
两 个 框 相 接触 的 地 方 ，depending 模块 使 用 了 exposing， 并 且 显 示 依 赖 于 它 。 两 种 
情况 都 使 用 了 exposed 模块 ( 阴影 区 域 )， 但 是 程度 不 同 : depending 模块 仅 在 边界 
上 使 用 exposed ( 上 )， 在 模块 内 部 使 用 相关 的 类 型 以 满足 一 些 需 求 (下 ) 


回 到 java.sql 的 示例 中 ,你 可 以 基于 依赖 模块 ( 比如 monitorpersistence ) 如 何 使 用 java.logging 
来 回答 这 个 问题 。 

口 它 可 能 仅 需 要 读 取 javalogging， 因 此 可 以 调用 java.sql.Driver.getParentLogger () ， 
改变 日 志 级 别 ， 然 后 一 切 就 绪 。 在 这 种 情况 下 ， 它 与 java.logging 的 交互 仅 局 限于 
monitor.persistence 和 java.sql 的 边界 ， 通 过 这 一 点 就 可 以 发 现 该 情况 适用 于 隐 式 可 读 性 。 

口 另 一 种 情况 是 ，monitorpersistence 可 能 会 在 整个 代码 中 使 用 日 志 模 块 功能 。 于 是 ,来自 
java.logging 中 的 类 型 会 出 现在 各 个 地 方 ， 而 且 与 Driver 无 关 ， 因 此 这 种 情况 不 再 被 视 
为 局 限于 边界 上 。 所 以 ，monitorpersistence 应 该 明确 引用 java.logging。 
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ServiceMonitor 应 用 程序 这 一 示例 可 以 采用 类 似 的 方案 .引用 了 monitor.observer.alpha 模块 的 
monitorpeek 是 否 仅 将 monitor.observer 中 的 类 型 用 于 创建 serviceobserver 对 象 ? 或 者 , 它 是 
否 在 与 monitor.observer.alpha 的 交互 之 外 独立 使 用 了 monitor.observer 中 的 类 型 ? 


11.1.5 ”基于 隐 式 可 读 性 重 构 模块 


乍 一 看 , 隐 式 可 读 性 像 一 个 解决 特定 用 例 的 小 特性 。 有趣 的 是 , 它 不 仅 限于 这 种 情况 ! 相反 ， 
它 解 锁 了 一 些 有 助 于 重 构 模 块 的 有 用 技术 。 

使 用 这 些 技术 的 动机 通常 是 防止 依赖 正在 重 构 的 模块 中 发 生 更 改 。 如 果 人 们 完全 控制 一 个 模 
块 的 所 有 客户 端 ， 并 且 一 次 性 地 编译 和 部 署 它们 ， 那 么 就 需要 更 改 它们 的 模块 声明 ( 仪 此 而 已 ， 
不 需要 更 复杂 的 事情 )。 但 是 通常 ， 比 如 在 开发 一 个 类 库 时 ， 人 们 做 不 到 这 一 点 ， 因 此 需要 一 种 
在 不 破坏 向 后 兼容 性 的 情况 下 重 构 模 块 的 方法 。 


1. 通过 聚合 器 模块 定义 模块 集合 

假设 应 用 程序 具有 几 个 核心 模块 , 并 且 其 他 几乎 所 有 模块 都 必须 依赖 于 它们 。 虽然 可 以 将 必 
要 的 requires 指令 复制 粘贴 到 每 个 模块 声明 中 , 但 这 很 烦琐 。 相 反 , 可 以 使 用 隐 式 可 读 性 来 创 
建 所 谓 的 聚合 器 模块 。 

聚合 器 模块 (aggregator module ) 本 身 不 包含 任何 代码 ， 它 仅 通过 requires transitive 
隐 式 可 读 性 的 指令 定义 所 有 依赖 , 用 于 创建 一 组 相关 的 模块 集合 ,而 其 他 模块 仅 需 要 引用 聚合 需 
模块 就 可 以 轻松 地 依赖 这 些 模块 。 

ServiceMonitor 应 用 程序 规模 较 小 ， 不 足以 使 用 聚合 器 模块 ， 但 为 了 举例 ， 本 节 决 定 将 
monitor.observer 和 monitorstatistics 作为 其 核心 API。 在 这 种 情况 下 , 可 以 按 如 下 方式 创建 monitorcore。 


module monitor.core { 
requires transitive monitor.observer; 
requires transitive monitor.statistics; 


} 


现在 ， 所 有 其 他 模块 都 可 以 通过 依赖 monitorcore 模块 方便 地 获得 monitorobserver 和 monitor. 
statistics 模块 的 可 读 性 。 图 11-6 直观 地 展示 了 此 示例 。 


不 包含 代码 包含 代码 




































































requires 


observer 


transitive 





requires 
到 为 core 使 用 了 隐 式 可 读 性 ， 每 个 读 取 core transitive 
模块 同时 也 可 以 读 取 observer 和 statistics， 
此 也 可 以 访问 它们 导出 的 包 
图 11-6 名 为 core 的 聚合 器 模块 〈 左 ) 不 包含 任何 代码 ， 并 且 使 用 requires transitive 
旧 令 聚合 observer 模块 和 statistics 模块 ( 右 )。 这 些 模块 中 包含 一 些 需 要 的 功能 。 由 
于 隐 式 可 读 性 ， 聚 合 器 模块 的 客户 端 可 以 使 用 被 聚合 的 模块 中 的 API 


statistics 【B) 
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当然 , 没有 理由 将 聚合 限制 于 核心 功能 。 每 个 共同 实现 同一 特性 的 模块 集合 都 潜在 地 适用 于 
通过 一 个 聚合 器 模块 来 呈现 。 

但 是 请 稍 等 ,聚合 需 模 块 是 否 将 客户 端 带 入 了 这 样 一 种 处 境 : 它们 在 内 部 使 用 了 未 被 显示 依 
赖 的 模块 的 API。 是 否 可 以 认为 ,前文 在 讨论 何 时 依赖 隐 式 可 读 性 时 提 到 ， 应 该 在 与 其 他 模块 的 
边界 上 使 用 它 ， 与 此 相 和 矛盾 ? 但 是 ， 这 里 的 情况 有 些 不 同 。 

聚合 器 模块 具有 特定 责任 , 即将 相关 模块 的 功能 绑 定 到 同一 个 单元 中 。 修改 捆绑 包 中 的 内 容 
是 一 项 重要 的 理念 性 改动 。 与 此 相反 ,“ 常 规 的 ” 隐 式 可 读 性 通常 应 用 在 不 直接 相关 的 模块 之 间 
(比如 java.sql 和 java.logging )， 其 中 被 隐 式 依赖 的 模块 往往 使 用 得 更 为 偶然 ( 尽管 更 改 API 仍然 
很 麻烦 ; 参见 15.2.4 芍 。 

如 果 你 对 面向 对 象 编程 的 术语 感 兴趣 ， 可 以 将 其 与 关联 、 聚 合 和 组 合 进行 比较 (这 种 比较 还 
远 远 不 够 完美 ， 而 且 术 语 也 不 是 整齐 划一 的 , 但 是 如 果 知 道 这 些 术 语 ,， 它们 应 该 会 给 你 一 些 直观 
的 感受 )。 

口 普通 的 reauires 指令 在 两 个 相关 模块 之 间 建 立 简 单 的 关联 。 

口 通过 requires transitive 将 此 转换 为 聚合 。 在 聚合 中 ， 一 个 模块 使 其 他 模块 变 为 其 

API 的 一 部 分 。 

口 聚合 器 模块 与 组 合 类 似 ， 因 为 所 涉及 的 模块 的 生命 周期 是 耦合 在 一 起 的 一 一 聚合 吉 模 块 
本 身 没有 存在 的 理由 。 不 过 ， 这 并 没有 完全 切中 要 害 ， 因 为 在 真正 的 聚合 中 ， 受 引用 的 
模块 没有 自己 的 目的 ， 而 聚合 器 模块 通常 有 自己 的 目的 。 

考虑 到 这 些 类 别 , 这 里 需要 介绍 一 下 。 需 要 某 个 聚合 的 公开 依赖 关系 由 11.1.4 节 所 介绍 的 准 
则 控制 ， 而 依赖 于 组 合 的 公开 依赖 关系 总 是 可 以 的 。 为 了 不 使 事情 变 得 更 复杂 ,本 书 的 其 余部 分 
将 不 使 用 聚合 和 组 合 这 两 个 术语 。 本 书 将 坚持 使 用 隐 式 可 读 性 和 聚合 器 模块 。 


要 点 最 后 ， 和 警告 一 句 : 聚合 器 模块 是 一 个 有 漏洞 的 抽象 ! 在 这 种 情况 下 ， 它 们 
泄漏 服务 、 合 规 导 出 和 合 规 开 放 。11.3 节 和 12.2.2 节 将 详细 介绍 合 规 导 出 和 合 规 
开放 ， 此 处 对 它们 仅 做 如 下 说 明 : 二 者 通过 命名 特定 的 模块 来 工作 ， 因 此 只 有 它 
们 才能 访问 一 个 包 。 尽 管 聚 合 器 模块 鼓励 开发 人 员 使 用 它 而 不 是 它 的 组 合 模块 ， 
但 是 将 包 导 出 或 开放 给 聚合 器 模块 是 没有 意义 的 ， 因 为 它 不 包含 自己 的 代码 ， 组 
合 器 模块 仍然 会 看 到 一 个 强 封装 的 包 。 

正如 10.2.2 节 所 解释 的 ， 服务 绑 定 还 消除 了 聚合 器 模块 是 完美 占 位 符 的 幻想 。 这 
里 的 问题 是 ， 如 果 一 个 组 合 模 块 提供 了 服务 ， 那 么 绑 定 将 把 其 引入 模块 图 中 。 但 
聚集 器 模块 ( 因为 它 没有 声明 提供 该 服务 ) 不 行 ， 因 此 其 他 组 合 模块 也 不 行 。 在 
创建 聚合 器 模块 之 前 ， 请 仔细 考虑 这 些 情况 。 

















































































































2. 通过 拆 分 模块 来 重 构 
我 相信 你 遇 到 过 这 样 的 情况 : 曾经 认为 简单 的 特性 现在 已 经 发 展 成 一 个 更 复杂 的 子 系统 。 你 
一 次 又 一 次 地 对 其 进行 改进 和 扩展 ， 它 变 得 有 些 纷乱 。 因 此 ， 要 清理 代码 库 ， 可 以 将 甚 重 构 为 更 
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小 的 部 分 ， 方便 更 好 地 进行 交互 ， 同 时 保持 其 公有 API 的 稳定 。 


Q 要 点 ”以 ServiceMonitor 应 用 程序 为 例 ， 它 的 统计 操作 可 能 有 大 量 代码 ， 因 此 将 
其 划分 为 几 个 较 小 的 子 项 目 ( 比如 Averages、 Medians 和 Percentiles ) 是 有 意义 的 。 
到 目前 为 止 ， 一 切 顺 利 。 现在， 考虑 一 下 它 如 何 与 模块 交互 。 


假设 一 个 简单 的 特性 有 自己 的 模块 , 而 新 的 解决 方案 将 使 用 几 个 模块 。 依赖 原始 模块 的 代码 
会 发 生 什么 ”如 果 不 依赖 原始 模块 ， 那 么 模块 系统 将 抱怨 缺少 依赖 关系 。 

在 经 过 刚才 的 讨论 后 ,为 什么 不 保留 原始 模块 ,并 将 其 转换 为 聚合 呢 ? 只 要 原始 模块 所 有 导 
出 的 包 现 在 都 由 新 模块 导出 ,这 就 是 可 能 的 ( 否则 , 新 的 聚合 器 模块 不 能 为 以 前 API 的 所 有 类 型 
提供 访问 权限 )。 




















要 点 ”要 保持 对 monitor.statistics 模块 的 依赖 不 变 ， 可 以 将 其 变 成 一 个 聚合 器 模 
块 ， 然 后 将 所 有 代码 都 移 到 新 模块 中 ， 编 辑 monitor.statistics 的 模块 声明 ， 通 过 
transitive 关键 字 添 加 对 新 模块 的 依赖 。 


module monitor.statistics { 
requires transitive monitor.statistics.averages; 
requires transitive monitor.statistics.medians; 
requires transitive monitor.statistics.percentiles; 





» 


请 参见 图 11-7 来 描述 这 种 分 解 。 这 是 一 个 很 好 的 机 会 ， 可 以 回顾 隐 式 可 读 性 的 传递 
性 : 在 前 面 的 示例 中 ， 所 有 模块 都 依赖 于 假想 的 monitor core 模块 ， 此 模块 也 将 
读 取 新 的 statistics 模块 , 因为 monitorcore requires transitive monitorstatistics ， 


而 monitor.statistics requires transitive 新 模块 。 


statistics 被 分 解 为 更 小 的 模块 


requires 
averages 


transitive 


requires 
statistics statistics medians  [B] 
transitive 





一 percentiles (C)) 


transitive 








由 于 隐 式 可 读 性 ， 读 取 statistics 的 模块 
能 够 访问 移动 到 更 小 模块 中 的 代码 
图 11-7 重 构 之 前 ,statistics 模块 包含 很 多 功能 ( 左 ), 将 其 分 解 为 包含 所 有 代码 的 3 个 更 小 
的 模块 ( 右 )。 为 了 不 强制 更 改 依赖 statistics 的 模块 ， 这 里 不 会 删除 statistics 模块 ， 
而 是 将 其 转换 为 一 个 聚合 器 模块 ， 这 意味 着 被 分 割 的 新 模块 具有 隐 式 可 读 性 
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如 果 想 让 客户 端 用 对 新 模块 的 更 具体 的 requires 指令 来 替换 对 旧 模 块 的 依赖 , 可 以 考虑 废 





弃 聚 合 带 。 
@Deprecated 


module my.shiny.aggregator { 
人 





11.1.6 ”通过 合并 模块 来 重 构 





尽管 可 能 比分 拆 模 块 的 频率 要 低 一 些 ， 但 是 你 会 遇 到 想 将 多 个 模块 合并 到 一 个 模块 的 情况 。 








和 以 前 一 样 , 删除 已 有 的 无 用 模块 可 能 会 破坏 客户 端 ; 同样 和 以 前 一 样 ， 可 以 使 用 隐 式 可 读 性 来 


解决 这 个 问题 : 


requires transitive 指令 © 








保留 空 的 旧 模 块 ， 并 确保 旧 模 块 声明 中 有 且 仅 有 一 行 


要 点 “在 ServiceMonitor 应 用 程序 中 , 你 可 
个 模块 是 多 余 的 ,并 希望 将 所 有 模块 都 合并 到 monitor.observer 中 ,把 monitorobserver 





人 
= 六， 





即 针对 新 模块 的 





能 会 意识 到 为 每 个 observer 实现 都 维护 一 


alpha 和 monitorobserverbeta 中 的 代码 移动 到 monitor.observer 比较 简单 ， 但 为 了 保持 


应 用 程序 直接 依赖 实现 模块 的 部 分 


@Deprecated 


module monitor.observer. 


requires transitive 


} 


@Deprecated 


module monitor.observer. 


requires transitive 


} 


可 以 在 图 11-8 中 看 到 这 些 模块 。 你 会 废弃 这 


alpha 和 beta 模 块 合 3 


observer 


包含 代码 


alpha 四 










requires 







requires 














图 11-8 重 构 之 前 ， 





代码 上 











以 保证 客 


alpha、 
所 有 的 功能 都 放 在 observer 模 块 中 , 空 的 alpha 和 Pbeta 模块 采 ) 
户 端 无 须 更 改 ( 右 ) 


不 需要 更 改 就 可 以 工作 ， 可 以 使 用 隐 式 可 读 性 


alpha { 
monitor.observer; 


beta { 
monitor.observer; 


文 些 模块 ， 以 提醒 用 户 更 新 依赖 。 
并 到 更 大 的 observer 模 块 中 


EE 


由 于 隐 式 可 读 性 ， 读 取 alpha 或 beta 的 
模块 可 以 访问 移 到 observer 中 的 代码 


beta 和 observer ( 左 ) 3 个 模块 共享 ; 重 构 之 后 ， 
j 隐 式 可 读 性 ， 








包含 代码 


requires 






transitive | observer 
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要 点 “不 过 ， 请 慎重 考虑 这 种 方法 。 这 会 使 依赖 较 小 模块 的 客户 端 突然 依赖 比 预 
期 大 得 多 的 模块 。 最 重要 的 是 ， 请 记 住 前 面 的 警告 ， 即 聚合 器 模块 是 一 个 有 漏洞 
的 抽象 。 





11.2 ”可 选 依赖 


在 3.2 节 中 ,可 以 看 到 模块 系统 使 用 *equires 指令 来 实现 可 靠 配 置 , 方法 是 在 编译 时 和 运 
行 时 确保 依赖 的 存在 。 但 是 ， 正 如 2.3 节 未 尾 所 讨论 的 ， 在 第 一 次 审视 ServiceMonitor 应 用 程序 
之 后 ， 这 种 方法 可 能 显得 过 于 死板 。 

在 某 些 情况 下 , 代码 最 终 使 用 的 类 型 不 一 定 在 运行 时 存在 一 一 它们 可 能 存在 , 但 不 一 定 存在 。 
按照 目前 的 情况 ， 模 块 系统 要 么 要 求 它们 在 启动 时 出 现 (使 用 requires 指令 )， 要 么 根本 不 允 
许 访问 它们 ( 当 不 使 用 时 )。 

本 节 将 展示 一 些 示 例 , 在 这 些 示 例 中 ,这 种 严格 依赖 的 特性 将 导致 一 些 问题 。 然 后 ， 本 节 将 
介绍 模块 系统 的 解决 方案 : 可 选 依赖 。 不 过 ,针对 可 选 依赖 编写 代码 并 不 简单 ， 所 以 本 节 会 仔细 
研究 一 下 。 在 本 节 的 最 后 , 你 将 能 够 编写 代码 ,使 不 必要 的 模块 在 运行 时 不 存在 。ServiceMonitor 
仓库 中 的 feature-optional-dependencies 分 支 演示 了 如 何 使 用 可 选 依赖 。 


11.2.1 可 靠 配置 的 难题 


假设 有 一 个 高 级 的 statistics 类 库 包 含 stats.fancy 模块 ， 后 者 无 法 每 次 部 署 ServiceMonitor 应 
用 程序 时 都 在 模块 路 径 上 存在 ( 原因 无 关 紧 要 ， 但 假设 这 是 一 个 许可 问题 )。 

你 希望 在 monitor.statistics 中 编写 使 用 了 fancy 模块 中 类 型 的 代码 , 但 要 实现 这 一 点 ,就 要 使 
用 reaquires 指令 来 依赖 它 。 如 果 这 样 做 ， 当 stats.fancy 模块 不 存在 时 ,模块 系统 则 不 会 让 应 用 
程序 启动 ,图 11-9 展示 了 这 种 死 锁 〈( 如果 这 个 例子 看 起 来 很 眼熟 ， 那 是 因为 你 以 前 从 另 一 个 角 
度 看 过 它 ， 在 兜 完 这 一 圈 后 ， 本 节 将 告诉 你 此 前 何 时 见 过 它 )。 



























































没有 reauires 指 令 有 requires 指 令 ， 那 么 
ea 模块 就 必须 始终 存在 


-OO 二 stats .fancy | ' stats.fancy 


图 11-9 可 靠 配置 的 难题 : 要 么 模块 系统 不 授予 statistic 对 stats.fancy 的 访问 权 ， 因 为 
statistics 不 需要 访问 ( 左 ); 要 么 statistics 需要 访问 ， 这 意味 着 应 用 程序 启动 
时 stats.fancy 必须 始终 存在 ( 右 ) 


男 一 个 例子 是 工具 类 库 一 一 uber .1ib， 它 集成 了 一 些 类 库 ， 其 API 提供 了 依赖 库 的 功能 ， 
从 而 公开 了 对 应 的 类 型 。 到 目前 为 止 , 如 11.1 节 所 讨论 的 , 这 可 能 看 起 来 像 是 隐 式 可 读 性 的 一 个 
简单 案例 ， 但 是 事情 可 以 从 另 一 个 角度 来 看 。 
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以 com.google .common 为 例 来 演示 一 下 ，uber .1ib 集成 了 它 。uper .1ib 的 维护 者 可 能 
会 假设 : 没有 使 用 Guava 的 用 户 不 会 调用 库 中 Guava 的 代码 。 这 是 非常 合理 的 。 如 果 你 没有 任何 
com.google.common .graph.Graph 的 实现 , 为 何 还 要 调用 uber.1ip 中 的 方法 为 它 的 实例 创 
建 报告 呢 ? 
对 于 uber.1ib 而 言 ， 这 意味 着 它 可 以 在 没有 com.google.common 的 情况 下 完美 运行 。 
如 果 Guava 进入 模块 图 ， 客 户 就 可 以 调用 uber .1ib 中 的 相关 API; 如 果 没 有 ， 就 不 会 调用 , 类 
库 照样 工作 得 很 好 。 可 以 说 从 自身 角度 出 发 ，uber .1ib 不 需要 此 依赖 。 

依据 本 书目 前 研究 的 特性 ， 这 种 可 选 关系 无 法 实现 。 根 据 第 3 章 的 可 读 性 和 可 访问 性 规则 ， 
uber .1ib 在 编译 时 必须 依赖 com.google.common， 从 而 强制 要 求 所 有 客户 端 在 启动 应 用 程序 
时 ， 模 块 路 径 中 必须 存在 Guava。 

如 果 uber .1ip 与 一 些 类 库 集成 , 将 使 客户 端 依 赖 于 所 有 类 库 , 哪怕 它 可 能 永远 不 会 使 用 这 
些 类 库 。 这 对 于 uber .1ib 而 言 不 是 一 个 好 主意 。 因 此 , 维护 人 员 会 寻找 一 种 方法 ,在 运行 时 将 
依赖 标记 为 可 选 。 正 如 下 一 节 所 述 ， 模 块 系统 已 经 涵盖 了 这 种 情况 。 


注意 ”构建 工具 也 知道 这 种 可 选 的 依赖 关系 。 在 Maven 中 ， 可 以 将 依赖 项 的 <optional> 
标记 设置 为 true; 在 Gradle 中 ， 可 以 在 compileonly 下 列 出 这 些 依赖 。 










































































11.2.2 ”静态 修饰 符 : 标记 可 选 依赖 


当 一 个 模块 需要 根据 男 一 个 模块 的 类 型 进行 编译 , 但 又 不 想 在 运行 时 依赖 它 时 , 可 以 使 用 一 
条 requires static 指令 来 建立 这 种 可 选 依赖 。 对 于 depending 和 optional 这 两 个 模块 ， 其 中 
依赖 的 声明 包含 一 行 requires static optional， 模 块 系统 在 编译 和 启动 时 的 行为 不 同 。 
口 在 编译 时 ， 必 须 提供 optional 模块 ， 否 则 将 出 现 错误 ; 在 编译 期 间 ，depending 模块 可 以 
读 取 optional 模块 。 
D 在 启动 时 ，optional 模块 可 能 不 存在 ， 这 不 会 导致 错误 或 警告 ， 如 果 可 选 模块 存在 ， 则 
depending 模块 可 以 读 取 此 模块 。 

表 11-1 将 此 行为 与 常规 的 requires 指令 进行 了 比较 。 注 意 ,， 尽管 模块 系统 没有 发 生 错 误 ， 
是 运行 时 仍然 可 能 发 生 错误 。 可 选 依赖 使 运行 时 更 有 可 能 发 生 错误 ( 比如 NoclassDefFounda- 
Error )， 因 为 模块 编译 时 所 针对 的 类 可 能 会 丢失 。 在 11.2.4 节 中 ， 你 将 看 到 防止 这 种 情况 出 现 
的 代码 。 


表 11-1 _ requires 和 requires static 在 编译 时 和 启动 时 针对 依赖 存在 和 依赖 丢失 两 种 情况 的 
行为 对 比 。 了 唯一 的 区 别 是 它们 在 启动 时 如 何 处 理 依赖 丢失 (最 右边 一 列 ) 
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依赖 存在 依赖 丢失 
编 译 时 启 动 时 编 译 时 启 动 时 
requires 读 取 读 取 报错 报错 
requires static 读 取 读 取 报错 忽略 
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例如 ， 让 我 们 创建 一 个 从 monitor.statistics 到 stats.fancy 的 可 选 依赖 。 为 此 ， 需 要 使 用 一 条 
requires static 指 今 。 


module monitor.statistics { 
requires monitor.observer; 
requires static stats.fancy; 
exports monitor.statistics; 
} 


如 果 编 译 时 缺少 stats.fancy 模块 ， 那 么 在 编译 模块 声明 时 会 出 现 如 下 错误 。 


> monitor.statistics/src/main/java/module-info.java:3: 
> error: module not found: stats.fancy 
> requires static stats.fancy; 

和 


> 
> 1 error 


另外， 在 启动 时 ,模块 系统 并 不 关心 是 否 存 在 stats.fancy 模块 。 
uber.lib 的 模块 描述 符 会 声明 所 有 依赖 为 可 选 依 赖 。 


module uber.lib { 
requires static com.google.common; 
requires static org.apache.commons.1lang; 
requires static org.apache.commons.io; 
requires static io.vavr; 
requires static com.aol.cyclops; 





} 

既然 你 已 经 知道 如 何 声明 可 选 依赖 ， 那 么 还 有 两 个 问题 需要 回答 。 

口 在 什么 情况 下 依赖 存在 ? 

口 如 何 针 对 可 选 依赖 编写 代码 ? 

下 文 将 回答 这 两 个 问题 ， 在 此 之 后 ， 你 就 可 以 使 用 这 个 方便 的 特性 了 。 


11.2.3 ”可 选 依赖 的 模块 解析 


正如 3.4.1 节 所 讨论 的 ， 横 块 解析 过 程 是 给 定 一 个 初始 模块 和 可 见 模块 全 集 ， 通 过 解析 1 
requires 指令 来 构建 模块 图 。 当 解析 一 个 模块 时 ， 其 需要 的 所 有 模块 都 必须 是 可 见 的 。 如 果 存 
在 ， 则 添加 到 模块 图 中 ; 否则， 将 发 生 错误 。 关 于 模块 图 ， 我 写 了 下 面 这 人 句 话 : 


需要 注意 的 是 ， 在 解析 期 间 没 有 进入 模块 图 的 模块 在 编译 或 执行 期 间 也 不 可 用 。 























要 点 “在 编译 时 ， 模 块 解析 流程 会 采用 同 处 理 常规 依赖 一 样 的 方式 处 理 可 选 依 
赖 。 另 外 ， 在 启动 时 ，reaquires static 指令 通常 会 被 忽略 ， 当 模块 系统 遇 到 
一 个 这 样 的 模块 时 ， 并 不 会 判断 其 是 否 满足 要 求 ， 这 意味 着 它 甚至 不 会 检查 模块 
是 否 可 见 。 
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因此 ， 即 使 模块 出 现在 模块 路 径 上 (或 者 JDK 中 )， 因 为 它 是 可 选 的 依赖 ， 也 不 
会 被 添加 到 模块 图 中 。 只 有 它 是 正在 解析 的 其 他 模块 的 一 个 常规 依赖 ， 或 是 因为 
命令 行 选项 --add-modules (参见 3.4.3 节 ) 显 式 添加 的 依赖 时 ， 才 会 进入 图 中 。 
图 11-10 演示 了 这 两 种 行为 ， 使 用 该 选项 确保 可 选 依赖 的 存在 。 
回 国 轿 (A) QE (A) 
庆 赖 ， 庶 赖 ; 
requires requires 
CE) 四 
requires requires 
static static 
根 模块 ， 根 模块 ， 
四 | © 
可 选 依赖 没有 加 入 模块 图 中 ， C 是 根 模块 ， 因 而 因为 C 在 模块 图 中 ， 所 以 
因而 C 不 在 模块 图 中 在 模块 图 中 可 选 依赖 添加 了 可 读 边 
图 11-10 “两边 都 显示 了 类 似 的 情况 。 这 两 种 情况 都 涉及 3 个 模块 ， 即 A、B 和 C， 其 中 A 严格 
地 依赖 于 B、 可 选 地 依赖 于 C。 在 左 侧 ，A 是 初始 模块 ， 由 它 产生 的 模块 图 中 没有 C， 
因为 可 选 依赖 不 会 被 解析 。 在 右 侧 ， 使 用 命令 行 选项 --add-modules 把 C 加 入 图 中 ， 
使 其 成 为 男 一 个 根 模块 ， 因 此 可 以 被 解析 并 且 A 可 以 读 取 C 
这 就 是 名 了 一 圈 的 地 方 。 本 节 第 一 次 提 到 fancy 统计 库 时 ， 解 释 了 为 什么 有 时 可 能 需要 显 式 
地 将 模块 添加 到 模块 图 中 。 那 时 并 没有 特别 讨论 可 选 依赖 〈 这 并 不 是 该 选项 的 唯一 用 例 )， 但 总 
体 思 路 与 现在 相同 : 由 于 fancy 统计 模块 没有 受到 强制 要 求 , 因此 它 不 会 被 自动 添加 到 模块 图 中 。 
如 果 想 将 其 添加 到 模块 图 中 ， 则 必须 使 用 --adad-modules 选项 命名 特定 
使 用 ALL-MODULE-PATH。 


也 许 你 在 模块 解析 过 程 中 遇 到 过 这 样 一 种 情景 : 可 选 依赖 
如 果 可 选 依赖 进入 模块 图 ， oe 。 因此 , 如 果 图 中 有 fancy 统计 模块 ( 可 
可 能 是 由 于 使 用 了 - -adqa-modqules ), 那么 任何 可 选 地 





能 是 由 于 使 用 了 常规 requires 指令 ， 
















































































依赖 于 它 的 模块 都 可 以 读 取 这 个 模块 。 这 Be 以 受到 直接 访问 。 


11.2.4 


针对 可 选 依赖 编写 代码 














通常 被 忽略 ” 为 什么 通常 这 样 ? 


型 


针对 可 选 依赖 
但 该 模块 在 运行 时 不 存在 ， 就 会 


Exception in thread "main" 
stats/fancy/FancyStats 





次 编写 代码 需要 考虑 更 多 ， 因 为 如 果 monitor.statistics 使 用 stats.fancy 中 的 类 型 
出 现 如 下 错误 。 


java.lang.NoClassDefFoundError: 





? 
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at monitor.statistics/monitor.statistics.Statistician 
.<init>(Statistician.java:15) 
at monitor/monitor.Main.createMonitor (Main.java:42) 
at monitor/monitor.Main.main (Main.java:22) 
Caused by: java.lang.ClassNotFoundException: stats.fancy.FancyStats 
. many more 


糟糕 ， 你 通常 不 希望 代码 出 现 这 种 情况 。 

一 般 来 说 ， 当 正在 执行 的 代码 引用 类 型 时 ，JVM 会 检查 该 类 型 是 否 已 经 加 载 。 如 果 没 有 ， 
则 会 告知 类 加 载 右 进行 加 载 ;， 如果 加 载 失 败 ， 就 会 出 现 NoclassDefFoundError， 通 常会 导致 
应 用 程序 崩 演 ,或 者 正在 执行 的 钠 辑 块 失败 。 

这 就 是 JAR 地 狱 臭名 昭著 之 处 〈 人 参见 1.3.1 节 )。 模块 系统 希望 通过 在 启动 应 用 程序 时 检查 
声明 的 依赖 来 克服 这 个 问题 。 但 是 对 于 requires static 你 选择 不 进行 检查 ， 这 意味 着 最 终 会 
得 到 一 个 NoclassDefFoundError， 对 此 能 做 些 什 么 呢 ? 

在 寻找 解决 方案 之 前 ,首先 需要 看 看 是 否 真 的 有 问题 。 以 uber .1ib 为 例 , 只 有 调用 的 代码 
已 经 使 用 了 该 类 型 , 你 才 希 望 使 用 来 自 可 选 依赖 的 类 型 , 这 意味 着 该 类 已 经 成 功 加 载 。 换 句 话说 ， 
当 调 用 uber .1ib 时 ， 所 有 必需 的 依赖 都 必须 存在 ， 否 则 调用 将 不 能 进行 。 所 以 根本 没有 问题 ， 
你 不 需要 做 任何 事情 ， 图 11-11 说 明了 这 种 情况 。 
因为 客户 端 代码 引用 了 可 选 依赖 ， 


所 以 uber.lib 的 可 选 依赖 的 所 有 执 
行路 径 已 经 传人 客户 端 


eT ， 一 ~ 人 ~> 执行 路 径 
是 人 er 1ip | 因 可 选 依赖 的 使 用 
图 11-11 假设 只 有 当 客 户 端 已 经 使 用 了 来 自 可 选 依赖 的 类 型 时 ， 调 用 upber .1ib 才 有 意义 。 
此 ， 所 有 依赖 于 可 选 依 赖 的 执行 路 径 ( 弯曲 线 ) 都 是 可 用 的 ，uber .1ib ( 上面 两 个 ) 
的 可 选 依 赖 已 经 通过 客户 端 代码 的 依赖 引入 ( 阴影 区 域 )。 如 果 加 载 没 有 失败 ， 那 么 
uber .1ip 也 不 会 执行 失败 
但 是 ,一般 情 况 有 所 不 同 ， 如 图 11-12 所 示 。 带 有 可 选 依赖 项 的 模块 很 可 能 首先 尝试 从 可 能 
不 存在 的 依赖 项 中 加 载 类 ， 因 此 发 生 NoclassDefFoundError 的 风险 非常 大 。 


































































































在 statistics 模 块 中 ， 拟 行路 径 首次 
遇 到 可 选 依赖 





~~~~> 执行 路 会 


4 statistics 可 选 依赖 的 使 用 








如 果 可 选 依赖 不 存在 ， 那 么 statistics 

模块 的 执行 就 会 失败 

图 11-12 一 般 情 况 下 ， 不 能 保证 调用 statistics 模块 的 客户 端 代码 已 经 引入 了 可 选 依赖 。 在 这 种 
情况 下 ， 在 statistics 模块 ( 阴影 区 域 ) 中 ， 执 行路 径 (弯曲 线 ) 可 能 会 首先 遇 到 可 选 
依赖 ， 如 果 可 选 依赖 没有 加 载 ， 则 会 导致 失败 
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要 点 “一 种 解决 方案 是 在 访问 依赖 项 之 前 对 具有 可 选 依赖 项 的 模块 进行 检查 。 如 
图 11-13 所 示 ， 该 检查 点 必须 评估 依赖 项 是 否 存在 ， 如 果 不 存在 ， 则 执行 相关 代 
码 的 不 同 路 径 。 


















检查 可 选 依赖 是 否 存在 ， 以 便 确 保 在 statistics 模 块 中 ， 执 行路 径 
执行 路 径 在 它 不 存在 时 可 以 转移 人 首先 会 遇 到 可 选 依赖 


~ 人 ~ 人 ~ 执行 路 径 

可 选 依赖 的 使 用 

。 可 选 依 赖 是 否 存在 
的 检查 点 








statistics 





灾难 避免 了 1 

图 11-13 为 了 确保 像 statistics 这 样 带 有 一 个 可 选 依赖 的 模块 ， 不 论 其 依赖 是 否 存在 都 
是 稳定 的 ， 这 里 需要 一 些 检查 点 。 基 于 该 依赖 是 否 存在 ， 代 码 的 执行 路 径 会 
不 同 (波浪 线 ); 或 者 执行 使 用 该 依赖 的 代码 ( 阴影 部 分 )， 或 者 执行 不 使 用 
该 依赖 的 其 他 代码 


模块 系统 提供 了 一 个 用 于 检查 某 个 模块 是 否 存 在 的 API。 这 里 暂时 不 会 详细 介绍 其 工作 原 
理 ， 因 为 还 缺少 一 些 需 要 理解 的 前 提 。 所 以 这 将 不 得 不 延迟 到 ( 你 也 可 以 直接 跳 到 ) 12.4.2 节 ， 
查看 一 个 可 以 实现 的 工具 方法 ,例子 如 下 所 示 。 


public static boolean isModulePresent (String moduleName) { 
A 












































} 


用 类 似 "stats .fancy "这样 的 参数 调用 这 个 方法 会 返回 这 个 模块 是 否 存 在 。 如 果 用 一 个 普 
通 依赖 的 名 称 〈 由 requires 指令 指定 的 ) 进行 调用 ， 返 回 结果 将 永远 是 true， 因 为 如 果 不 是 
这 样 ， 模 块 系统 将 不 会 允许 应 用 程序 启动 。 

如 果 用 一 个 可 选 依赖 的 名 称 〈 由 requires static 指令 指定 的 ) 调用 它 ,那么 返回 结果 将 
有 可 能 是 true 或 者 false。 如 果 某 个 可 选 依赖 存在 ,模块 系统 建立 起 了 对 它 的 可 读 性 , 那么 沿 
着 使 用 这 个 模块 中 的 类 型 的 执行 路 径 走 则 是 安全 的 。 反 之 ,如 果 该 可 选 依赖 不 存在 , 那么 选择 这 
个 路 径 将 导致 NoclassDefFoundError， 因 此 将 不 得 不 使 用 男 一 个 依赖 。 


11.3” 合 规 导出 : 将 可 访问 性 限制 在 指定 的 模块 中 


鉴于 前 两 节 展 示 了 如 何 改 善 依 赖 ， 本 节 将 介绍 一 个 可 以 做 出 优雅 的 API 设 计 的 机 制 。 如 3.3 
节 所 述 ， 通 过 exports 指令 将 包 导 出 我 们 定义 了 一 个 模块 的 公有 API， 在 这 种 情况 下 ， 所 有 读 
取 此 模块 的 其 他 模块 ,都 可 以 在 编译 时 和 运行 时 访问 这 些 导 出 包 中 的 所 有 公有 类 型 。 这 是 强 封闭 
的 核心 要 素 一 一 3.3.1 节 曾 深入 介绍 过 。 

在 完成 上 述 讨论 之 后 , 你 需要 做 出 选择 : 是 对 包 进行 强 封装 ,还 是 使 其 在 任何 时 间 对 任何 人 
都 可 访问 。 为 了 处理 无 法 明确 适用 于 二 者 之 一 的 特殊 用 例 , 模块 系统 提供 了 两 种 不 是 那么 直率 的 
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方式 来 导出 一 个 包 : 合 规 导出 ( 马上 就 要 讲解 ) 以 及 开放 式 包 ( 因为 与 反射 相关 ，12.2 节 将 对 此 
进行 介绍 ) 和 以 前 一 样 ， 在 介绍 具体 机 制 之 前 ， 本 节 将 先 介绍 一 个 例子 。 在 本 节 末 尾 ， 相 较 于 
使 用 普通 的 exports 指令 ， 你 将 可 以 更 精确 地 对 外 暴露 API。 看 一 下 ServiceMonitor 仓库 的 
feature-qualified-exports 分 支 ， 以 了 解 合 规 导出 是 如 何 工作 的 。 


























11.3.1 ”公开 内 部 API 


说 明 exports 指令 过 于 笼统 的 最 好 例子 来 自 于 JDK。 如 7.1 节 所 述 ， 只 有 一 个 平台 模块 导 
出 sun.* 包 ， 而 鲜 有 平台 模块 导出 com. sun.* 包 。 但 这 是 否 意 味 着 所 有 其 他 包 都 只 被 用 于 它们 
声明 所 在 的 模块 呢 ? 
远 不 是 这 样 ! 很 多 包 在 不 同 模块 间 进行 共享 。 这 里 有 一 些 例子 。 
口 基础 模块 javabase 的 内 部 代码 在 很 多 地 方 得 到 使 用 。 比 如 ，java.sql ( 提供 Java 数据 库 连 接 
API[JDBC] ) 使 用 jdk.internal.misc、 jdk.internal.reflect 以 及 sun.reflect . 
misc。 像 sun . security.provider 和 sun.security.action 这 样 与 安全 相关 的 包 
被 java.rmi ( 远程 方法 调用 API[RMI] ) 或 java.desktop (AWT 和 Swing 用 户 接口 工具 包 ， 
以 及 可 访问 性 、 多 媒体 和 JavaBeans API ) 使 用 。 
口 java.xml 模块 定义 Java API for XML Processing ( JAXP )， 包 含 了 Streaming API for XML 
( StAX )、Simple API for XML (SAX ) 以 及 W3C 文 档 对 象 模型 (DOM ) API。 它 的 内 部 
包 中 有 6 个 ( 大 多 数 以 com.sun.org.apache.xml 和 com. sun. org.apache.xpath 
作为 前 级 ) 被 java.xml.crypto (XML 加密 API ) 使 用 。 
口 很 多 JavaFX 模块 访问 javafx.graphics ( 大 多 是 通过 com. sun.javafx.*), 后 者 依次 使 用 
了 来 自 javafx.swing ( 集成 了 JavaFX 和 Swing ) 的 com.sun.javafx.embed.swing, 而 
后 者 又 进一步 依次 使 用 了 java.desktop ( 就 像 sun.awt 和 sun.swing ) 的 7 个 内 部 包 ， 
而 后 者 又 进一步 a 
我 可 以 继续 举例 ,但 我 确定 你 已 经 明白 我 的 意思 了 。 这 带 来 了 一 个 问题 : JDK 如 何在 模块 间 
共享 这 些 包 ， 而 不 需要 把 它们 导出 给 所 有 这 些 模块 ? 
虽然 JDK 确定 无 疑 拥有 最 强大 的 目的 性 导出 机 制 的 用 例 ， 但 是 并 不 是 只 有 它 才 拥有 这 样 的 
用 例 。 每 当 一 系列 模块 想 要 在 彼此 之 间 共 享 一 些 功能 而 不 将 这 些 功能 导出 时 都 是 这 样 的 状况 一 一 
这 可 以 是 类 库 、 框 架 ， 甚 至 更 大 型 应 用 程序 的 模块 子 集 。 
这 与 在 模块 系统 引入 前 隐藏 工具 类 的 问题 很 相似 。 一 旦 某 个 工具 类 必须 在 不 同 的 包 中 被 使 
用 ， 就 不 得 不 向 其 赋予 公有 访问 权限 。 但 是 在 Java 9 之 前 ， 这 意味 着 同一 个 JVM 中 运行 的 所 有 
代码 都 可 以 访问 它 。 现 在 你 遭遇 了 类 似 的 问题 : 想 要 隐藏 一 个 工具 包 , 但 是 一 旦 它 必须 在 不 同 的 
模块 中 得 到 使 用 ， 就 必须 被 导出 ， 进 而 可 以 被 在 同一 个 JVM 中 运行 的 所 有 模块 访问 一 一 至 少 在 
目前 所 使 用 的 机 制 中 是 这 样 。 图 11-14 描述 了 这 种 相似 性 。 
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\ FancyUtil 
































其 他 模块 











所 有 代码 均 可 访问 所 有 代码 均 可 访问 

( 左 ) 在 Java9 之 前 , 一 旦 某 个 类 型 是 公有 的 (就 像 util 包 中 的 FancyUtil )， 

它 就 可 以 被 所 有 其 他 代码 访问 。( 右 ) 一 个 类 似 的 情况 是 模块 , 但 是 在 一 个 更 高 的 

级 别 ， 一旦 某 个 包 被 导出 ( 就 像 utils.fancy 模块 中 的 util 包 )， 它 就 可 以 被 所 有 
其 他 模块 访问 


图 11-14 


11.3.2 ”将 包 导 出 给 模块 

exports 指令 可 以 通过 在 其 后 面 追 加 to $ {modules} 来 修饰 ， 其 中 s {modules} 是 一 个 由 
逗号 分 隔 的 模块 名 列表 ( 里 面 不 允许 出 现 占 位 符 )。 对 于 exports to 指令 所 指定 的 模块 来 说 ， 
被 指定 的 包 可 以 像 普通 的 exports 指令 一 样 被 访问 。 对 于 所 有 其 他 模块 来 说 ， 这 个 包 会 被 强 封 
装 ， 如 同 没 有 exports 指令 一 样 。 图 11-15 展示 了 这 种 情况 。 

























privileged 


regular 


reads 





exported to 








可 以 访问 


无 法 访问 ， 因 为 没有 导出 





11-15 ”模块 拥有 者 通过 合 规 导出 让 pack 包 仅 可 被 privileged 模块 访问 。 对 于 privileged 
模块 来 说 ， 该 包 和 普通 的 导出 包 一 样 可 访问 ; 但 是 对 于 其 他 模块 ( 比如 regular ) 
而 言 ， 则 不 可 访问 


举 一 个 例子 ,假设 ServiceMonitor 应 用 程序 中 所 有 的 观察 者 实现 都 需要 
首要 的 问题 是 ,这些 类 型 应 该 放 在 哪里 。 所 有 的 观察 者 都 已 经 依赖 于 monitorobserver， 因 为 它 包 
含 了 它们 所 实现 的 Serviceopservez 接口 , 那么 为 什么 不 与 它 放 在 一 起 呢 ? 好 的 , 它们 最 终 被 
放 进 了 monitor.observer.utils 包 。 

现在 ， 有 趣 的 事情 发 生 了 。 下 面 是 monitorobserver 的 模块 声明 ， 将 这 个 新 的 包 仅 导出 给 实 


现 模块 。 








共享 一 些 工具 代码 。 
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module monitor.observer { 
exports monitor.observer; 
exports monitor.observer.utils 
to monitor.observer.alpha, monitor.observer.beta; 


} 


尽管 monitor .observer 被 导出 给 所 有 模块 ， 但 是 仅 有 monitor.observer.alpha 和 monitor. 

observer.beta 可 以 访问 monitor .observer .utils。 

这 个 例子 演示 了 两 个 有 趣 的 细 市 。 

口 被 某 个 包 导 出 到 的 模块 可 以 依赖 于 导出 模块 ， 这 就 导致 了 一 个 循环 依赖 。 思 考 
非 使 用 隐 式 可 读 性 ， 那 么 一 定 是 这 种 情况 : 被 其 个 包 指 
方式 读 取 导出 模块 呢 ? 

口 任何 时 候 ， 一 个 新 的 实现 想 使 用 这 些 工 具 ， 都 需要 改动 API 模块 ， 以 便 它 可 以 被 这 个 新 
模块 访问 。 虽 然 让 导出 模块 控制 谁 可 以 访问 它 的 导出 包 属 于 合 规 导 出 的 思路 ， 但 该 过 程 
还 是 有 些 复杂 。 

举 一 个 真实 世界 中 的 例子 ， 本 节 原 本 希望 展示 java.base 所 声明 的 合 规 导 出 ， 但 是 一 共有 65 个 ， 

















下 ， 除 
定 导 出 到 的 模块 ， 如 何 用 其 他 的 











到 [ 























太 多 了 。 于 是 ， 通 过 java --descripbe-module java.xml (参见 $.3.1 节 ) 来 看 一 下 java.xml 
的 模块 描述 符 。 

> module java.xml@9.0.4 

# 省 略 了 合 规 导 出 之 外 的 所 有 信息 

> qualified exports com.sun.org.apache.xml.internal.utils 

> to java.xml .crypto 

> qualified exports com.sun.org.apache.xpath.internal.compiler 

> to java.xml .crypto 

> qualified exports com.sun.xml.internal.stream.writers 

> to java.xml .ws 

> qualified exports com.sun.org.apache.xpath.internal 

> to java.xml .crypto 

> qualified exports com.sun.org.apache.xpath.internal.res 

> to java.xml .crypto 

> qualified exports com.sun.org.apache.xml.internal .dtm 

> to java.xml .crypto 

> qualified exports com.sun.org.apache.xpath.internal.functions 

> to java.xml .crypto 

> qualified exports com.sun.org.apache.xpath.internal.objects 

> to java.xml .crypto 














上 面 的 输出 显示 ，java.xml 让 java.xml.crypto 和 java.xml.ws 使 用 了 一 些 内 部 API。 





现在 你 已 经 了 解 了 合 规 导出 ， 下 面 可 以 详细 解释 在 5.3.6 节 分 析 模块 系统 日 志 时 留 下 的 一 个 


小 细节 了 。 你 曾 看 到 过 类 似 这 样 的 信息 。 


> Adding read from module java.xml to module java.base 

> package com/sun/org/apache/xpath/internal/functions in module java.xml 
is exported to module java.xml.crypto 

> package javax/xml/datatype in module java.xml 

is exported to all unnamed modules 


> 


> 





238 第 11 章 完善 依赖 关系 和 API 








当时 本 书 没有 解释 为 什么 日 志 提 及 了 导出 到 一 个 模块 , 但 是 了 解 了 刚刚 所 讨论 的 内 容 , 这 个 
问题 就 清楚 了 。 如 你 在 最 近 的 例子 中 所 见 到 的 那样 ，java.xml 将 com.sun.org.apache. 
xpath.internal.functions 导出 到 java.xml.crypto， 这 恰好 是 第 2 条 信息 所 提 及 的 。 第 3 条 
言 息 的 意思 是 将 javax.xml .datatype 导出 给 “所 有 无 名 模块 ”， 这 看 上 去 有 些 奇怪 ， 但 这 就 
是 模块 系统 的 说 明 方式 。 它 说 明 ， 该 包 被 导出 却 不 需要 进一步 合 规 验证 ， 因 此 可 被 所 有 读 取 
java.xml 的 模块 (包括 无 名 模块 ) 访问 。 

要 点 “最 后 ， 关 于 编译 ， 有 两 条 小 提示 。 

口 如 果 编 译 某 个 声明 了 合 规 导 出 的 模块 ， 并 且 目 标 模块 不 存在 于 可 见 模块 全 集 
中 , 编译 器 就 会 产生 一 个 警告 。 这 并 不 是 一 个 错误 ,因为 目标 模块 虽然 被 提 及 ， 
但 并 非 强制 需要 。 

口 在 exports 和 exports to 指令 中 不 允许 使 用 同一 个 包 。 如 果 两 个 指令 都 存在 ， 那 
么 后 者 是 没有 意义 的 ,因此 , 这 种 情况 被 解释 为 实现 错误 , 进而 导致 编译 错误 。 























11.3.3 ”什么 时 候 使 用 合 规 导 

合 规 导 出 使 多 个 模块 可 以 共享 同一 个 包 ， 又 不 至 于 使 该 包 对 同一 个 JVM 中 的 所 有 其 他 模块 
可 见 。 这 使 得 合 规 导出 对 于 包含 多 个 模块 的 类 库 和 框架 尤为 有 用 , 因为 它 可 以 用 于 在 它们 之 间 共 
享 代码 ,也 可 以 避免 客户 端 使 用 这 些 代码 ,对 于 想 限 制 对 特定 API 进行 依赖 的 大 型 应 用 程序 来 说 ， 
它 也 非常 有 用 。 

合 规 导出 可 被 视 为 将 强 封 装 由 在 工件 中 对 类 型 进行 保护 提升 为 在 模块 集合 中 对 包 进 行 保护 。 
图 11-16 对 此 进行 了 描述 。 









































公有 但 未 可 以 访问 导出 的 ， 所 以 
导出 的 可 被 访问 
(\ 类 型 模块 
+—( ( 
<—({ ) 已 dO 
+ 
2 
不 可 模块 边界 不 可 到 未 授权 模块 的 边界 
访问 访问 
国 国 国 国 国 1 
由 于 强 封装 ， 类 型 对 于 模块 于 合 规 导 出 ， 包 对 于 授权 范围 
之 外 ` 的 代码 是 不 可 访问 的 之 外 的 模块 是 不 可 访问 的 
11-16 〈 左 ) 未 导出 包 中 的 公有 类 型 可 以 被 同一 个 模块 中 的 其 他 类 型 访问 ， 而 不 能 被 其 

















他 模块 中 的 类 型 访问 。( 右 ) 类 似 地 (但 是 在 更 高 层次 )， 合 规 导出 被 用 来 让 某 个 
模块 中 的 包 对 被 指定 的 一 系列 模块 而 言 可 访问 ， 而 对 未 授权 的 模块 而 言 不 可 访问 





11.3 合 规 导出 : 将 可 访问 性 限制 在 指定 的 模块 中 239 








假设 你 在 设计 一 个 模块 , 什么 时 候 你 会 倾向 于 使 用 合 规 导出 ,而 不 使 用 不 合 规 导出 呢 ? 要 回 
答 这 个 问题 ， 就 需要 聚焦 在 合 规 导出 的 核心 优势 上 ， 即 控制 谁 可 以 使 用 某 个 API。 总 的 来 说 ， 可 
能 产生 问题 的 包 离 客户 端 越 远 ， 这 个 优势 就 变 得 越 重要 。 

假设 你 有 一 个 小 型 或 中 型 应 用 程序 ， 其 由 若干 模块 (不 算 依赖 模块 ) 组 成 ， 这 些 模块 由 一 个 
开发 小 组 维护 , 并 且 进 行 一 次 性 编译 和 部 署 。 在 这 种 情况 下 ,控制 哪个 模块 使 用 哪个 API 还 算 简 
单 ， 并 且 如 果 某 些 地 方 出 了 错 ， 很 容易 修复 ， 因 为 所 有 的 因素 都 在 控制 之 中 。 在 这 样 的 场景 中 ， 
合 规 导出 的 优势 很 有 限 。 

在 舞台 的 另 一 端 是 JDK。 可 以 说 , 它 被 世界 上 的 每 一 个 Java 项 目 所 使 用 ， 并 且 对 向 后 兼容 
有 着 极致 的 关注 。 让 外 部 的 代码 依赖 于 一 个 内 部 API 会 导致 很 多 问题 ， 并 且 这 些 问 题 难以 修复 ， 
所 以 对 控制 “ 谁 可 以 访问 什么 ”的 需求 是 非常 迫切 的 。 

这 两 端 最 明显 的 分 界线 是 , 是 否 可 以 自由 地 对 客户 端 代码 进行 改动 。 如 果 你 正在 开发 某 个 模 
块 以 及 它 所 有 的 客户 端 模块 ， 并 且 可 以 自由 地 改动 客户 端 代码 ， 那 么 普通 的 导出 是 不 错 的 选择 ; 
如 果 你 维护 的 是 一 个 类 库 或 者 框架 , 并 且 无 法 自由 地 改动 客户 端 代码 , 那么 只 有 那些 你 想 让 客户 
端 使 用 且 你 愿意 维护 的 API 可 以 被 自由 导出 。 除 此 之 外 , 尤其 是 内 部 工具 , 应 该 仅 被 导出 到 自己 
的 模块 中 。 

在 规模 更 大 的 项 目 中 , 这 条 分 界线 会 变 得 模糊 不 清 。 如 果 一 个 大 型 代码 库 被 大 型 团队 维护 多 
年 , 虽然 从 技术 上 来 说 他 们 可 以 对 所 有 的 客户 端 进行 改动 , 并 且 由 于 一 个 API 改 动 而 不 得 不 如 此 
做 , 但 这 可 能 会 是 相当 痛苦 的 一 件 事 。 在 这 种 情况 下 , 使 用 合 规 导出 不 仅 能 阻止 意外 依赖 于 内 部 
包 ， 还 能 帮助 记录 某 个 API 是 为 哪个 客户 端 设计 的 。 


11.3.4 ”通过 命令 行 导出 包 


如 果 在 编码 时 没有 预见 到 要 使 用 内 部 API ( 或 者 更 可 能 的 情况 是 ， 无 意 中 使 用 了 内 部 API )， 
该 怎么 办 ? 如 果 代码 不 得 不 访问 所 属 模块 没有 ( 不 论 合 规 与 否 ) 导出 的 类 型 ， 该 怎么 办 ? 如 果 模 
块 系统 严格 遵守 这 些 规 则 , 那么 很 多 应 用 程序 将 无 法 在 Java 9 及 以 上 版 本 中 编译 或 加 载 。 但 是 如 
果 强 封装 可 以 轻易 绕 过 ， 就 很 难说 它 是 “ 强 ” 封 装 了 ,， 它 也 会 因此 丧失 优势 。 折 中 的 办 法 是 ， 定 
义 一 个 命令 行 选 项 ， 将 其 作为 逃生 舱 ， 但 由 于 太 过 复杂 ， 其 不 适合 作为 普遍 的 解决 方案 。 

除了 exports to 指令 ， 还 有 一 个 命令 行 选项 有 着 相同 的 效果 ， 可 以 用 在 编译 顺和 运行 时 
命令 中 : 












































































































































































































































通过 --add-exports $s{module}/s$s{package}=${accessing-modules}， 模块 系 
统 将 $module 的 $ftpackage} 导 出 到 逗号 分 隔 列 表 $ {accessing-modules}) 中 提 到 的 所 有 模块 
中 。 如 果 其 中 包含 ALL-UNNAMED， 那 么 无 名 模块 中 的 代码 也 可 以 读 取 这 个 包 。 

3.3 节 中 呈现 的 一 般 可 访问 性 规则 适用 于 通过 --aqd-exports 选项 访问 某 个 类 型 的 模块 ,下 
面 的 条 件 必 须 得 到 满足 : 
口 类 型 必须 是 公有 的 ; 
口 类 型 必须 在 $ {package} 中 ; 
D ${accessing-modules} 中 提 到 的 模块 必须 可 以 读 取 $ {module}。 
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举 个 ada_exports 的 例子 ,在 7.13 节 和 7.1.4 节 中 ， 你 兽 用 这 个 选项 在 编译 时 和 运行 时 
得 到 过 对 平台 模块 内 部 API 的 访问 权限 。 与 其 他 命令 行 选 项 一 样 ， 让 --add-exports 选项 以 实 
验 之 外 的 身份 出 现 会 影响 项 目的 可 维护 性 ， 细 节 参 见 9.1 节 。 


11.4 ”小 结 


口 隐 式 可 读 性 。 

加 通过 requires transitive 指令 ， 一 个 模块 可 以 让 它 的 客户 端 代码 读 取 某 个 模块 ， 
即便 客户 端 代码 所 在 模块 不 明确 地 依赖 于 后 者 也 是 如 此 。 这 使 得 一 个 模块 可 以 在 它 的 
API 中 使 用 依赖 模块 中 的 类 型 ， 而 不 要 求 在 客户 端 代码 模块 中 人 工地 依赖 这 些 模块 。 最 
终 ， 这 些 模块 对 于 客户 端 代 码 立即 可 用 。 

里 如 果 一 个 模块 仅 在 相应 的 直接 依赖 模块 的 边界 使 用 ， 那 么 这 个 模块 应 该 仅 依赖 于 隐 式 
可 读 的 传递 依赖 。 一 旦 这 个 模块 开始 通过 使 用 传递 依赖 来 实现 自己 的 功能 ， 就 应 该 将 
传递 依赖 变 成 直接 依赖 。 这 可 以 确保 模块 声明 能 够 反映 出 真正 的 依赖 关系 ， 并 且 计 这 
个 模块 能 够 更 加 健壮 地 应 对 可 能 将 这 个 传递 依赖 移 除 的 重 构 。 

里 可 以 利用 隐 式 可 读 性 在 模块 间 移 动 某 段 代码 ， 让 曾经 包含 这 段 代码 的 模块 对 目前 包含 
这 段 代 码 的 模块 隐 式 地 表明 可 读 性 。 这 使 得 客户 端 代 码 可 以 访问 所 依赖 的 代码 而 不 用 
要 求 它们 改变 模块 声明 ， 因 为 它们 最 终 仍然 可 以 读 取 包含 这 些 代码 的 模块 。 保 持 这 样 
的 兼容 性 对 于 类 库 和 框架 尤其 重要 。 

口 可 选 依赖 。 

四 借助 requires static 指令 ， 模 块 将 标明 一 个 依赖 ， 使 模块 系统 保证 这 个 依赖 在 编 
译 时 存在 ， 在 运行 时 却 可 以 缺席 。 这 就 让 基于 模块 的 代码 不 用 强制 它们 的 客户 端 在 应 
用 程序 中 始终 包含 这 些 模块 。 

四 在 启动 时 ， 仅 通过 requires static 指令 被 需要 的 模块 不 会 被 放 入 模块 图 ， 即 便 它 
们 是 可 见 的 也 是 如 此 。 人 们 必须 通过 --add-modules 手动 添加 它们 。 

a 面向 可 选 依赖 的 编码 需要 确保 执行 路 径 不 会 由 于 模块 缺失 而 失败 ， 因 为 这 会 极 大 地 前 
弱 模 块 的 可 用 性 。 

口 合 规 导 出 。 

上 四 通过 exports to 指令 ， 模 块 中 的 某 个 包 可 以 只 被 指定 的 模块 访问 。 这 是 除 将 包 封装 
和 使 它 可 被 所 有 其 他 代码 访问 之 外 的 第 三 个 选项 ， 其 更 有 目的 性 。 

四 导出 到 指定 模块 可 以 在 不 需要 公有 API 的 情况 下 ， 在 一 系列 被 授权 模块 间 共 享 代码 。 
这 减少 了 类 库 或 模块 的 API 范围 ， 提 高 了 可 维护 性 。 

和 借助 --add-exports 命令 行 选项 , 可 以 将 开发 者 打算 作为 内 部 API 的 包 在 编译 时 和 运 
行 时 导出 。 一 方面 ， 这 使 得 依赖 于 这 些 内 部 API 的 代码 可 以 运行 ; 另 一 方面 ， 这 将 引 
和 人 自身 的 可 维护 性 问题 。 














































































































模块 化 世 弄 中 的 反射 








本 章 内 容 
口 对 反射 开放 包 和 模块 
口 模块 与 反射 相 结合 
口 反射 API 的 替代 品 
口 分 析 和 修改 模块 属性 





ee 











如 果 你 的 工作 内 容 是 一 个 Java 应 用 程序 , 那么 你 将 很 有 可 能 需要 Spring、Hibernate、JAXP、 
GSON 或 者 同类 框架 。 什 么 是 “同类 框架 ”? “同类 框架 ” 指 的 是 那些 通过 Java 的 反射 API 检 
查 代码 、 搜 索 注 解 、 实 例 化 对 象 或 者 调用 方法 的 框架 。 多亏 了 反射 这些 框 架 可 以 在 无 须 编译 代 
码 的 情况 下 实现 上 述 所 有 功能 。 

此 外 , 反射 API 允许 框架 访问 非 公有 类 和 非 公 有 成 员 。 它 对 编译 过 的 代码 有 着 异乎 寻常 的 超 
能 力 ， 为 非 公有 类 或 成 员 打破 了 包 的 界限 。 但 问题 是 ,在 模块 化 系统 中 ， 反 射 不 再 开 箱 即 用 。 它 
丧失 了 其 超 能 力 , 被 束缚 到 与 被 编译 的 代码 相同 的 访问 规则 下 ,只 能 访问 导出 包 中 公有 类 的 公有 
成 员 。 另 外 , 这些 框 架 通常 会 针对 非 公 有 的 字段 和 方法 ， 以 及 你 不 想 导 出 的 类 (它们 不 属于 模块 
的 API ) 使 用 反射 。 那 该 怎么 办 ? 本 章 全 部 内 容 都 与 这 个 问题 相关 。 

为 了 能 在 本 章 小 有 收获 ， 你 需要 做 以 下 准备 。 

口 对 反射 如 何 工 作 (参见 附录 B ) 有 基本 的 理解 。 

口 了 解 这 个 事实 : 每 次 在 某 个 地 方 添加 一 个 注解 都 是 让 某 个 框架 对 这 个 类 进行 反射 访问 ( 具 
体例 子 参见 代码 清单 12-1 )。 

口 理解 可 访问 性 规则 (参见 3.3 欧 。 


代码 清单 12-1 基于 反射 的 标准 与 框架 的 代码 片段 
// JPA 
@Entity 
@Table (name = "user") 
public class Book { 










































































@Id 
@GeneratedValue (strategy = GenerationType.SEQUENCE) 
@Column (name = "id", updatable = false, nullable = false) 








你 的 代码 从 类 路 径 中 运行 ， 


代码 ， 以 及 对 反射 API 的 替代 币 
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private Long id; 
@Column (name = "title", nullable = false) 
private String title; 
Liss] 
} 
// JAXB 


@xmlRootElement (name = "book") 
@xmlAccessorType (XmlAccessType.FIELD) 
public class Book { 


@xmlElement 
private String title; 


@xmlElement 
private String author; 


| 
} 


// SPRING 

@RestController 

public class BookController { 
@RequestMapping (value = "/book/{id}", 

QResponseBody 

public Book getBook (@PathVariable("id") 
Car | 


} 


method = RequestMethod .GET) 


long id) { 


掌握 了 这 些 ， 你 就 可 以 了 解 为 什么 exports 指令 对 允许 反射 访问 模块 不 会 有 太 大 帮助 ( 参 
见 12.1 节 )， 以 及 怎样 做 才能 提供 帮助 (参见 12.2 节 )。( 注意 ,这 仅 对 清晰 模块 有 意义 一 一 如 果 








它 就 没有 被 封装 ， 所 以 无 须 为 此 担心 。) 


但 是 本 章 “ 不 仅 ”与 准备 反射 可 以 访问 的 模块 有 关 ， 还 包含 了 另 一 方面 : 讨论 如 何 更 新 反射 





























I 补充 ( 参见 12.3 节 )。 本 章 以 如 何 使 用 层 在 运行 时 动态 加 载 模块 


(参见 12.4 节 ) 结尾 。( 这 两 节 是 为 在 Java 9 之 前 就 遇 到 此 类 用 例 的 开发 者 准备 的 ， 所 以 与 本 章 


其 他 小 节 相 上 


的 项 目 也 包括 被 反射 访问 的 项 目 。 你 也 能 够 通过 反射 在 
上 件 的 应 用 程序 。 


扣 














上 ， 阅 读 它们 更 需要 熟悉 反射 和 类 加 载 机 制 。) 


学 完 本 童 后 , 你 将 了 解 让 项 目 为 模块 世界 的 反射 做 准备 所 需要 的 全 部 知识 , 既 包括 实现 反射 








运行 时 动态 加 载 代 码 ， 比 如 实现 一 个 基于 
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12.1 为 何 exports 指令 不 能 很 好 地 适用 于 反射 


在 深入 讲解 如 何 让 代码 为 反射 做 准备 之 前 , 有 必要 先 说 明 一 下 为 什么 到 目前 为 止 本 书 所 讨论 
的 导出 类 的 机 制 ， 即 exports 指令 (参见 3.3 节 )， 不 适用 于 反射 。 主 要 有 3 个 原因 
口 为 此 类 框架 而 设计 的 类 是 否 应 该 属于 模块 的 公有 API 是 非常 有 争议 的 ; 
口 将 这 些 类 导出 到 一 个 指定 的 模块 会 将 模块 耦合 到 一 个 实现 而 不 是 标准 ; 
口 导出 无 法 支持 对 于 非 和 有 字段 和 方法 的 深 反 射 。 

丁 会 先 回顾 一 下 在 模块 系统 出 现 之 前 反射 是 如 何 运 行 的 , 之 后 会 对 上 面 3 个 原因 逐一 进行 
讲解 。 


12.1.1 深入 非 模块 化 代码 


假如 就 像 第 6 章 和 第 7 章 中 描述 的 那样 ， 你 已 经 将 应 用 程序 成 功 迁 移 到 Java 9 及 以 上 版 本 ， 
但 还 没有 将 它 模 块 化 ， 所 以 它 还 在 类 路 径 中 运行 。 在 这 种 情况 下 ， 对 代码 的 反射 会 像 在 Java 8 中 
一 样 继续 工作 。 

基于 反射 的 框架 会 通过 访问 非 公有 类 型 和 成 员 例 行 地 创建 和 修改 类 实例 。 虽 然 无 法 基于 包 可 
见 或 私有 元 素 编 译 代码 ， 但 是 在 将 它们 标记 为 可 访问 后 ， 反 射 使 人 们 可 以 使 用 它们 。 代 码 清 
12-2 展示 了 一 个 假定 持久 化 框架 ， 它 使 用 反射 创建 一 个 实体 ， 并 且 为 一 个 私有 字段 指定 ID。 


代码 清单 12-2 使 用 反射 
























































Clagses<?> type 三 ws -十 框架 为 了 得 到 该 类 
Constructor<?> constructor = entityType.getConstructor(); 要 做 的 事情 
constructor.setAccessible(true); 四 





Object entity = constructor.newInstance(); 
Field id = entity.getDeclaredField("id"); 
id.setAccessible(true); -3 
id.set (entity, 42); 


想象 一 下 ,应 用 程序 被 模块 化 ， 在 代码 和 这 些 框架 之 间 突 然 出 现 了 一 条 模块 边界 。 那 么 模块 
系统 ， 尤 其 是 exports 指令 ,为 了 使 内 部 类 型 可 访问 ,会 留 下 哪些 选项 呢 ? 


12.1.2 ”使 内 部 类 型 强制 公有 
要 点 根据 3.3 节 所 讨论 的 可 访问 性 规则 ， 为 了 可 以 被 访问 , 类 型 必须 是 公有 的 ， 


并 且 存 在 于 一 个 已 导出 的 包 中 。 这 同样 适用 于 访问 ,所 以 ,在 没有 使 用 exports 
外 令 的 情况 下 ， 你 会 得 到 如 下 异常 。 


让 很 可 能 为 私有 的 构造 函数 和 
字段 对 于 后 面 的 调用 可 访问 












> Exception in thread "main" java.lang.IllegalAccessException: 

> class p.X (in module A) cannot access class gq.Y (in module B) 
because module B does not export gq to module A 

> at java.base/....Reflection.newIllegalAccessException 

> at java.base/....AccessibleObject.checkAccess 

> at java.base/....Constructor.newInstance 
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这 好 像 在 提示 ，Spring、Hibernate 等 框架 需要 访问 的 类 必须 是 公有 的 ， 并且 其 所 在 的 包 必须 
被 导出 。 尽 管 这 使 得 它们 被 添加 为 模块 的 公有 API, 但 到 目前 为 止 我 们 都 一 直 认 为 这 些 类 型 是 内 
部 的 ， 因 此 这 是 一 个 非常 严肃 的 决定 。 

如 果 你 在 写 一 个 只 有 几 千 行 代码 的 小 服务 , 那么 将 这 些 代码 划分 到 少数 几 个 模块 中 , 也 许 不 
是 一 个 大 问题 。 毕 竟 , 在 这 样 的 规模 下 ， 模 块 的 API 和 关系 不 太 可 能 引起 大 规模 的 混乱 , 但 同样 
这 也 不 是 需要 模块 发 挥 所 长 的 场景 。 

另 一 方面 , 如 果 你 面 对 的 是 一 个 规模 更 大 的 代码 库 ,该 代码 库 拥 有 数 十 万 甚至 数 百 万 行 代码 ， 
这 些 代码 被 划分 到 几 十 个 或 者 上 百 个 模块 中 , 由 几 十 个 开发 者 共同 开发 , 那么 问题 会 变 得 非常 不 
同 。 在 这 种 情况 下 ， 导 出 一 个 包 会 给 其 他 开发 者 一 个 强烈 的 信号 : 可 以 在 模块 之 外 使 用 这 些 类 ， 
它们 是 专门 为 跨 模块 边界 使 用 而 设计 的 。 毕 竟 ， 这 就 是 导出 的 目的 。 

但 是 ， 由 于 本 研究 的 出 发 点 是 出 于 某 种 原因 而 不 希望 公开 这 些 类 ， 因 此 显然 很 重视 封装 。 
如 果 模 块 系统 迫使 人 们 将 不 想 被 访问 的 元 素 标记 为 受 支 持 的 ， 那 就 太 讽 刺 了 ,这 就 是 所 谓 的 弱 


封闭。 


12.1.3 ” 合 规 导出 导致 对 具体 模块 的 耦合 


此 时 此 刻 , 回想 一 下 11.3 节 , 并 考虑 使 用 合 规 导 出 来 确保 只 有 一 个 模块 可 以 访问 这 些 内 部 类 
型 。 首 先 ， 为 这 次 驻足 思考 喝彩 一 一 这 确实 可 以 修复 刚刚 描述 的 问题 。 

尽管 如 此 ， 它 可 能 会 引入 一 个 新 的 问题 。 思 考 一 下 JPA 以 及 它 的 诸多 实现 ， 比 如 Hibernate 
和 EclipseLink。 依 据 你 的 风格 ， 你 也 许 曾 努力 避免 对 所 选 实 现 的 直接 依赖 ， 所 以 不 希望 通过 
exports ... to concrete.jpa.implementation 将 某 一 个 实现 硬 编码 到 模块 声明 中 。 如 
果 你 依赖 合 规 导 出 ， 则 无 法 实现 这 一 点 。 


12.1.4 不 支持 深 反射 


不 得 不 让 作为 实现 细节 的 类 型 可 以 被 其 他 代码 访问 确实 让 人 头疼 ,但 这 还 不 是 最 糟糕 的 。 

比如 说 ， 你 选 定 了 exports 指令 (不 论 合 规 与 否 )， 以 便 所 选 框架 能 够 访问 所 需 的 类 。 虽 然 
通常 有 可 能 仅 对 公有 成 员 使 用 基于 反射 的 框架 ， 但 这 有 既 不 能 应 对 所 有 情况 ， 也 不 是 最 好 的 方式 。 
作为 对 比 , 通常 可 以 依赖 私有 字段 或 非 公 有 方法 的 深 反射 ,避免 将 与 框架 相关 的 细节 导出 到 其 他 
代码 。( 代码 清单 12-1 展示 了 一 些 例子 , 代码 清单 12-2 展示 了 如 何 通过 使 用 setAccessible 来 
访问 内 部 代码 。) 
要 点 尽管 总 的 来 说 很 幸运 ,但 是 在 这 一 点 上 很 不 幸 一 一 将 类 型 设 为 公有 及 将 包 
导出 不 会 为 非 公有 成 员 授 了 予 可 访问 性 。 如 果 框 架 试图 调用 setAccessible 方法 ， 
那么 你 将 得 到 这 样 的 错误 。 



















































































> Exception in thread "main" java.lang.reflect.InaccessibleObjectException: 
> Unable to make field gq.Y.field accessible: 
> module B does not "opens gq" to module A 
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at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible 
at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible 
at java.base/java.lang.reflect.Field.checkCanSetAccessible 

at java.base/java.lang.reflect.Field.setAccessible 


VV vvyV 





如 果 一 定 要 沿 着 这 条 路 径 往 下 走 , 你 将 不 得 不 让 所 有 被 反射 访问 的 成 员 公 有 化 ,而 这 将 让 前 
面 所 提 的 “将 封装 弱化 ”的 结论 进一步 恶化 。 

概括 来 说 ， 对 主要 用 于 反射 的 代码 使 用 exports 指令 ， 其 缺点 如 下 。 
口 仅 允 许 对 公有 成 员 的 访问 ， 而 这 通常 要 求 将 实现 细 广 公有 化 。 
口 允许 其 他 模块 对 公开 的 类 和 成 员 进 行 编译 。 
口 合 规 导出 可 能 会 让 你 的 代码 耦合 到 具体 实现 而 非 声明 。 
口 将 包 标 记 为 模块 公有 API 的 一 部 分 。 
以 上 4 点 哪个 最 恶劣 ， 你 可 以 自行 决定 。 我 选 最 后 一 个 。 


12.2 开放 式 包 和 模块 为 反射 而 生 


现在 ， 我们 已 经 建立 了 清晰 的 认识 ，exports 用 于 使 代码 可 被 基于 反射 的 类 库 访问 是 多 么 
不 合适 。 那 么 模块 系统 提供 了 什么 替代 方案 呢 ? 

答案 是 opens 指令 ， 并 且 在 引入 相应 的 合 规 变 体 ( 类似 于 exports ... to， 参见 12.2.2 
节 ) 之 前 ， 它 是 我 们 首先 要 考虑 的 (参见 12.2.1 节 )。 为 了 确保 你 使 用 了 正确 的 工具 ， 我 们 将 详 
尽 地 比较 导出 模块 与 开放 式 模块 的 效果 (参见 12.2.3 节 )。 最 后 是 授予 反射 访问 权限 的 利器 : 开 
放 式 模块 (参见 12.2.4 区 。 


12.2.1 为 运行 时 访问 开放 式 包 






















































































定义 : opens 指令 

在 模块 声明 中 添加 opens ${package} 指 令 可 以 将 一 个 包 开 放 。 在 编译 时 ， 开 放 式 包 是 
强 封装 的 : 开放 式 包 和 非 开 放 式 包 之 间 没 有 任何 区 别 。 在 运行 时 ， 开 放 式 包 完 全 可 以 被 访问 ， 
包括 非 公 有 类 、 方 法 和 字段 。 





monitorpersistence 模块 使 用 Hibernate， 所 以 开放 一 个 包含 实体 的 包 ， 人 允许 对 其 进行 反射 。 | 1 2 


module monitor.persistence { 
requires hibernate.jpa; 
requires monitor.statistics; 


exports monitor.persistence; 
opens monitor.persistence.entity; 
} 
这 就 使 Hibernate 可 以 与 StatisticsEntity 这 样 的 类 共同 工作 (参见 代码 清单 12-3 )。 
为 包 没 有 被 导出 ， 所 以 其 他 ServiceMonitor 模块 无 法 对 它 所 包含 的 类 型 进行 编译 。 
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代码 清单 12-3 ”statisticsEntity 代码 片段 ， 被 Hibernate 反射 访问 
@Entity 
@Table(name = "stats") 
public class StatisticsEntity { 











@Id 

@GeneratedValue (strategy = GenerationType.AUTO) 

private int id; < 、 
Hibernate 会 把 值 注入 
、\ t En 

@ManyToOne 这 些 私 有 字段 中 

@JoinColumn (name = "gquota_ id", updatable = false) 

private LivenessQuotaEntity totalLivenessQuota; > | 

private StatisticsEntity() { } Hibernate 也 可 以 访问 

和 私有 构造 函数 


} 


可 以 看 到 ，opens 指令 为 反射 的 用 例 而 设计 ， 并 与 exports 行为 凶 异 : 

口 允许 访问 所 有 成 员 ， 因 此 不 会 影响 你 对 可 访问 性 的 决定 ; 

口 防止 对 开放 式 包 中 的 代码 进行 编译 ， 仅 允许 运行 时 访问 ; 

口 标明 该 包 为 基于 反射 的 框架 而 设计 。 

除 在 此 特定 用 例 中 exports 的 明显 技术 优势 之 外 ， 还 有 最 重要 的 一 点 : 通过 opens 指令 ， 
可 以 用 代码 清楚 地 表明 ， 此 包 并 不 用 于 一 般 用 途 , 仅 供 特 定 工 具 访问 。 如 果 愿 意 的 话 ， 你 甚至 可 
以 让 包 只 对 这 个 工具 的 模块 开放 。 如 5.2.3 节 所 述 ， 如 果 你 想 针对 诸如 配置 或 者 媒体 文件 这 样 位 
于 包 中 的 资源 进行 访问 授权 ， 你 也 需要 开放 它们 。 


12.2.2 ”为 特定 模块 开放 式 包 


前 文 一 直 讨 论 的 opens 指令 使 所 有 模块 可 以 反射 访问 一 个 开放 的 包 。 这 与 exports 指令 使 
所 有 模块 可 以 访问 导出 包 类 似 。 同时 , 正如 exports 可 以 被 限制 为 仅 由 特定 模块 访问 (参见 11.3 
各 ，opens 也 可 以 。 
























































定义 : 合 规 开放 

opens 指令 可 通过 在 其 后 加 上 to gsS{fmodqules} 而 受到 限定 ， 其 中 S{fmodqules} 是 一 个 由 
号 分 隔 的 模块 名 称 列表 ( 里 面 不 允许 出 现 占 位 符 )。 对 于 opens to 指令 声明 的 模块 来 说 ， 
包 将 与 带 有 普通 opens 指令 时 一 样 可 被 访问 。 对 于 所 有 其 他 模块 来 说 ， 该 包 会 被 强 封装 ， 
仿佛 根本 没有 opens 指令 一 样 。 


过 
该 


为 了 让 封装 更 强 ，monitorpersistence 可 以 仅 将 它 的 实体 包 开 放 给 Hibernate。 


module monitor.persistence { 
requires hibernate.jpa; 
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requires monitor.statistics; 

exports monitor.persistence; 

// 假设 Hibernate 是 一 个 清晰 模块 

opens monitor.persistence.entity 
to hibernate.core; 


} 




















如 果 规 范 和 实现 是 分 开 的 (例如 ，JPA 和 Hibernate )， 你 可 能 会 认为 在 模块 声明 中 提 及 实现 
有 些 奇 怪 。12.3.5 节 对 这 个 想法 做 了 解释 ,结论 是 : 直到 为 了 纳入 模块 系统 而 将 标准 更 新 ， 这 都 
是 必要 的 。 

12.2.3 节 将 讨论 何 时 可 以 使 用 合 规 开放 ， 但 在 此 之 前 ， 先 正式 介绍 曾 在 7.1 节 中 使 用 过 的 一 
个 命令 行 选项 。 



































定义 : --add-opens 

--add-opens ${module}/s{package}=s${reflecting-module} 选 项 将 ${module} 模 
块 的 Sf{package} 包 开放 给 $f{reflecting-module}。${reflecting-module} 中 的 代码 因此 能 够 访问 
${package} 中 的 所 有 类 型 和 成 员 ， 且 不 论 它 们 是 公有 的 还 是 非 公有 的 都 是 如 此 ,但 其 他 模块 
不 能 。 

当 指 定 ${reading-module} 为 ALL-UNNAMED 时 ， 类 路 径 中 的 所 有 代码 ， 或 者 更 准确 地 说 ， 
无 名 模块 中 的 所 有 代码 (参见 8.2 节 )， 可 以 访问 该 包 。 在 迁移 到 Java 9 及 以 上 版 本 时 ， 你 应 
该 永远 使 用 该 占 位 符 一 一 一 旦 代码 在 模块 中 运行 ， 你 就 可 以 将 开放 式 包 限制 到 指定 模块 。 




















如 果 对 相关 例子 感 兴趣 ， 可 以 去 看 一 下 7.1.4 节 中 的 最 后 一 个 例子 。 
因为 --add-opens 绑 定 到 反射 ， 这 是 一 个 纯 运 行 时 概念 ， 所 以 它 仅 对 java 命令 有 意义 。 
很 有 趣 的 是 ， 它 在 javac 命令 中 也 可 用 ， 但 是 会 造成 一 个 警告 


吝 口 o 


























> warning: [options] --add-opens has no effect at compile time 


关于 为 什么 javac 不 直接 拒绝 --add-opens 选项 , 我 的 猜测 是 ， 这样 做 能 够 在 编译 和 启动 
之 间 共 享 与 模块 系统 相关 的 命令 行 选项 的 参数 文件 。 

















注意 什么 是 参数 文件 ? 你 可 以 将 编译 参数 和 JVM 参数 放置 于 一 个 文件 中 ， 并 通过 
javac efile-name 和 java efile-name 将 它们 添加 到 命令 中 ( 细节 参见 Java 文档 )。 


12.2.3 ”导出 包 与 开放 式 包 的 对 比 


exports 和 opens 指令 有 一 些 共同 点 : 

D 它们 都 使 得 包 的 内 容 跨 模块 边界 可 用 ; 

口 它们 都 拥有 一 个 合 规 变 体 to s {modules}， 可 以 将 访问 权限 限制 为 指定 的 模块 列表 ; 
口 它们 都 有 javac 和 java 的 命令 行 选 项 ， 在 必要 的 时 候 可 用 其 绕 过 强 封装 。 

二 者 的 不 同 之 处 在 于 何 时 以 及 为 谁 进行 访问 授权 : 
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有 API; 

















口 导出 包 在 编译 时 授予 对 公有 类 型 和 成 员 的 访问 权限 ， 完 美 地 定义 其 他 模块 可 以 使 用 的 公 


口 开放 式 包 仅 在 运行 时 授予 对 所 有 类 型 和 成 员 〈 包 括 非 公有 的 ) 的 访问 权限 ， 非 常 适合 为 
基于 反射 的 框架 授权 访问 本 该 处 于 模块 内 部 的 代码 。 




















表 12-1 对 此 做 了 总 结 。 或 许 你 可 以 翻 回 表 7-1， 回 顾 一 下 如 何 通过 --adqd-exports 和 


--add-opens 获取 对 内 部 API 进行 访问 的 权限 。 


表 12-1 对 封装 包 、 导 出 包 、 开 放 式 包 在 何 时 以 及 为 谁 授予 权限 的 对 比 





























访问 编 译 时 运 行 时 

类 或 成 员 公 有 非 公 有 公有 非 公 有 
封装 包 x x x x 

导出 包 x 六 

开放 式 包 x x v v 

也 许 你 会 好 奇 ， 是 否 可 以 将 exports 和 opens 指令 , 不 论 合 规 的 还 是 不 合 规 的 ， 都 组 合 到 





一 起 ? 如 果 可 以 ， 又 该 怎么 做 呢 ? 答案 很 简单 : 随 你 喜欢 ， 任 何方 式 都 可 以 。 






































to 和 opens。 











口 如 果 你 的 Hibernate 实体 是 公有 API， 那 么 使 用 exports 和 opens。 
口 如 果 只 想 让 少数 几 个 应 用 程序 模块 在 编译 时 访问 Spring 上下文， 那么 使 用 exports ... 





电 许 这 4 个 组 合并 不 是 每 一 个 都 有 相关 的 用 例 ( 并 且 你 应 该 将 代码 设计 为 不 需要 它们 中 的 任 





何 一 个 )， 但 如 果 遇 到 了 其 中 的 某 一 个 用 例 ， 你 可 以 相应 地 组 合 这 些 指 令 。 

当 谈 论 到 opens 指令 是 否 应 该 被 限制 到 特定 模块 时 ， 本 书 意见 是 ， 这 些 额 外 的 工作 通常 不 
值得 去 做 。 虽然 合 规 导出 是 一 个 非常 重要 的 工具 ,能 够 避免 其 他 同事 和 用 户 意 外 引入 对 内 部 API 
的 依赖 (更 多 细节 参见 11.3.3 节 ), 但 是 合 规 开放 的 “目标 听众 ”是 一 些 框架 ,它们 完全 不 依赖 
于 你 的 代码 。 不 论 是 否 仅 对 Hibernate 开放 某 个 包 ，Spring 都 不 会 对 它 产生 依赖 。 如 果 你 的 项 目 





























对 自己 的 代码 使 用 了 很 多 反射 , 事情 就 会 变 得 不 太一 样 。 但 是 这 种 情况 下 本 书 建议 的 默认 选项 是 


完全 开放 
12.2.4 ”开放 式 模块 :批量 反射 





不 需要 合 规 。 


最 终 ， 如 果 有 一 个 大 型 模块 ， 其 中 很 多 包 被 反射 使 用 ， 你 会 发 现 将 它们 逐一 开放 非常 麻烦 。 





定义 : 开放 式 模块 


虽然 没有 opens com.company .* 这 样 的 通配符 ， 但 是 该 问题 有 类 似 的 解决 办 法 。 


在 模块 声明 的 module 之 前 添加 open 关键 字 可 以 创建 开放 式 模 块 。 


open module S${module-name} { 
requires S${module-name}; 
exports ${package-name}; 
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// 不 允许 opens 
上 


开放 式 模块 将 其 包含 的 所 有 包 开 放 类 似 于 对 每 个 包 使 用 opens 指令 。 因 此 ， 没 有 必要 再 
手动 开放 其 中 的 一 些 包 ， 因 为 编译 器 在 开放 式 模 块 中 不 再 接受 opens 指令 。 








使 用 opens monitor.persistence.entity 的 殖 代 选项 是 开放 monitor.persistence 模块 。 


open module monitor.persistence { 
requires hibernate.jpa; 
requires monitor.statistics; 


exports monitor.persistence; 


} 


如 你 所 见 , 开放 式 模 块 确实 只 是 一 种 简便 方法 , 其 可 以 帮助 避免 对 几 十 个 包 进行 逐一 手动 开 
放 。 然 而 在 理想 情况 下 应 该 不 需要 这 么 做 ,因为 你 的 模块 不 会 这 么 大 。 一 种 会 出 现 这 么 多 开放 式 
包 的 场景 是 ， 在 模块 化 的 过 程 中 ， 你 将 一 个 大 的 JAR 在 拆 分 前 转变 成 一 个 大 型 模块 。 这 也 是 为 
什么 jaeps 可 以 为 开放 式 模块 生成 模块 声明 ， 参 见 9.3.2 节 。 


12.3 ”针对 模块 进行 反射 


12.1 节 和 12.2 节 探 索 了 如 何 将 代码 开放 给 反射 ， 以 便 Hibernate 和 Spring 这 样 的 框架 进行 访 
问 。 由 于 大 多 数 Java 应 用 程序 使 用 此 类 框架 ， 因 此 你 将 经 常 遇 到 这 样 的 场景 。 

现在 切换 到 另 一 边 ， 对 模块 化 代码 进行 反射 。 了 解 它 的 工作 原理 会 很 有 帮助 ， 你 对 反射 API 
的 理解 将 被 刷新 。 但 是 大 多 数 开发 者 很 少 有 编写 反射 代码 的 需求 ,因此 你 通常 不 需要 这 么 做 。 所 
以 , 本 节 将 着 重 讨论 针对 模块 进行 反射 和 相关 代码 一 些 值得 注意 的 方面 ， 而 不 会 详尽 介绍 所 有 相 
关 的 话题 和 API。 

本 节 首 先 会 探讨 为 什么 不 需要 为 了 使 用 模块 化 代码 而 改变 已 有 的 反射 代码 (参见 12.3.1 欧 ， 
以 及 为 什么 需要 切换 到 一 个 更 加 现代 的 API (参见 12.3.2 节 )。 接 下 来 会 讨论 模块 本 身 ， 其 在 反 
射 API 中 有 重要 的 表现 , 该 反射 API 可 以 被 用 来 对 它们 进行 查询 (参见 12.3.3 节 ) 甚至 更 改 ( 参 
见 12.3.4 节 )。 最 后 本 节 在 结尾 处 会 详细 讨论 如 何 更 改 一 个 模块 ， 以 允许 其 他 模块 对 它 进 行 反射 
访问 (参见 12.35 欧 。 


12.3.1 更 新 模块 的 反射 代码 或 不 更 新 ) 


在 尝试 踏 入 新 领域 之 前 ， 由 于 模块 系统 引起 的 变化 ， 你 关于 反射 的 知识 储备 需要 随 之 更 新 。 
尽管 了 解 反射 如 何 处 理 可 读 性 和 可 访问 性 的 确 不 错 , 但 是 你 会 发 现在 代码 中 并 不 需要 进行 太 多 的 
更 改 。 更 重要 的 是 ,你 可 以 告知 用 户 ， 在 创建 模块 时 他 们 必须 做 什么 。 


1. 对 于 可 读 性 ， 没 有 什么 需要 做 的 
本 书 反复 说 明 的 一 件 事 是 ， 反 射 的 可 访问 性 约束 规则 与 静态 访问 一 致 (参见 3.3 节 )。 首 先 ， 
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这 意味 着 要 使 一 个 模块 中 的 代码 能 够 访问 男 一 个 模块 中 的 代码 , 前 者 必须 能 够 读 取 后 者 。 尽管 如 
此 , 一 般 来 说 ， 人 们 不 以 这 种 方式 设置 模块 图 一 一 比如 Hibernate 通常 不 会 读 取 应 用 程序 模块 。 

















要 点 ” 听 起 来 像 是 反射 模块 需要 添加 一 条 连接 被 反射 模块 的 可 读 边 ， 并 且 确 实 有 
一 个 API 用 于 完成 该 任务 (参见 12.3.4 节 )。 由 于 反射 总 是 需要 该 可 读 边 ， 然 而 
总 是 添加 上 它 ， 可 能 又 会 陷入 不 可 避免 的 样板 模式 ， 因 此 反射 API 在 其 内 部 进行 
了 这 些 操作 。 总 而 言 之 ， 你 无 须 担 心 可 读 性 。 





2. 对 于 可 访问 性 ， 没 有 什么 可 以 做 的 

访问 代码 的 下 一 个 障碍 是 它 需 要 被 导出 或 开放 。 正 如 12.2 节 详 细 讨 论 的 那样 ， 这 确实 是 一 
个 问题 ,就 算 你 是 反射 库 的 作者 ， 也 对 此 几乎 无 能 为 力 。 要 人 么 模块 的 所 有 者 开放 或 导出 包 ， 要 么 
什么 也 做 不 了 。 
































A 要 点 ”模块 系统 不 限制 可 见 性 ， 类 似 Class::forName 的 调用 ， 或 者 通过 反射 


入 ) 的 方法 获得 构造 函数 、 方 法 和 字段 的 引用 ， 都 是 可 行 的 ; 可 访问 性 是 受 限制 的 ， 
如 果 没 有 权限 访问 被 反射 的 模块 ， 那 么 调用 构造 函数 或 方法 、 访 问 字 段 以 及 调用 








Accessibleobject::setAccessipble 都 会 失败 ， 并 且 抛 出 Inaccessible- 
ObjectException 异常 。 











InaccessibleobjectException 扩展 了 RuntimeException， 使 它 成 了 未 经 检查 的 异常 
( unchecked exception )， 因 此 编译 髓 不 会 强制 你 捕获 它 。 但 是 请 确保 你 要 执行 ， 并且 应 该 执行 捕获 
的 操作 一 一 这 样 可 以 为 用 户 尽 可 能 地 提供 更 有 帮助 的 错误 信息 。 有 关 示 例 ， 参 见 代 码 清单 12-4。 






































定义 : AccessibleObject::trySetAccessible 

如 果 你 希望 检查 可 访问 性 不 会 引发 异常 ， 那 么 Java 9 中 新 添加 的 AccessibleObject:: 
trySetAccessible 方法 就 是 为 你 准备 的 。 它 的 核心 功能 与 setAccessible (true) 类 似 : 
使 底层 成 员 变 得 可 访问 ， 并 且 利用 其 返回 值 来 表明 是 否 能 正常 工作 。 如 果 可 访问 性 已 授权 ,， 则 
返回 true; 否则 返回 false。 代 码 清 单 12-4 展 示 了 其 运行 方式 。 





代码 清单 12-4 ”处 理 无 权 访问 代码 的 3 种 方法 
private Object constructWithoutExceptioHandling (Class<?> type) 
throws ReflectiveOperationException { 





Constructor<?> constructor = type.getConstructor(); 

constructor.setAccessible(true); | 四 

return constructor a 本 次 调用 会 抛 出 Inaccessibleobject- 
: Exception 异常 ， 并 且 因 为 没有 明确 捕 


获 ， 用 户 被 迫 要 自行 处 理 该 问题 
private Object constructWithExceptionHandling (Class<?> type) 
throws ReflectiveOperationException, FrameworkException { 
Constructor<?> constructor = type.getConstructor(); 


12.3 ”针对 模块 进行 反射 ” 251 





让 


constructor.setAccessible(true); < 





} catch (InaccessibleObjectException ex) 
throw new FrameworkException(createErrorMessage (type), ex 


此 处 , 异常 被 转化 为 框架 特有 的 异常 ， 


} 


return constructor.newInstance(); 


} 


{ 


并 且 有 额外 的 错误 信 


的 上 下 文 状态 


private Object constructWithoutException(Class<?> type) 


throws ReflectiveOperationException, 


FrameworkException { 


Constructor<?> constructor = type.getConstructor(); 


boolean isAccessible = constructor.trySetAccessible(); 4 


if (!isAccessible) 
throw new FrameworkException(createErrorMessage (type)); 


return Consttructor .newInSstance () ; 


} 


} 


以 上 方法 除了 确保 你 能 





和 


言 息 描述 异常 发 生 





使 用 trysetAccessible 方法 ， 初 始 的 异常 不 


会 再 发 生 , 但 是 在 这 个 例子 中 依旧 抛 出 了 一 个 框 
架 特 有 的 异常 〈 以 用 于 处 理 无 权 访问 的 情况 ) 
private String createErrorMessage (ClLass<?> type) { 
return "When doing THE FRAMEWORK THING, accessing " 
+ type + "'s parameterless constructor failed " 
+ "because the module does not open the containing package. " 
































正确 处 理 无 权 访问 代码 的 情况 外 , 其 他 什么 也 做 不 了 。 在 更 新 基于 模 





块 系统 的 项 目 时 ,你 遇 到 的 不 仅 是 技术 上 的 挑战 ， 更 是 沟通 上 的 挑战 : 用 户 需要 知道 正在 使 用 的 


这 些 项 目 可 能 需要 访问 哪些 依赖 包 ,以 及 应 如 何 处 到 


指导 的 好 地 方 。 
专用 的 JPMS 说 明 页 














它们 。 显 而 易 见 ， 项 目的 文档 是 对 用 户 进行 





说 一 些 稍微 偏离 主题 的 内 容 。 本 书 建议 在 项 目的 文档 中 创建 一 个 专用 的 说 明 页 ， 用 于 向 使 
用 模块 的 用 户 描 述 应 做 的 准备 工作 。 这 些 内 容 越 集中 ,用 户 搜索 到 它们 的 可 能 性 就 越 大 ， 因此 
不 要 将 其 埋 在 繁杂 的 文档 中 。 本 书 还 建议 通过 借助 Javadoc 以 及 访问 与 失败 相关 的 异常 消息 等 


方法 广泛 传播 这 些 文档 


资源 。 


12.3.2 ”使 用 变量 句柄 代替 反射 


Java9 引 入 了 一 个 新 的 API， 名 为 变量 句柄 ( variable handle )， 它 扩展 了 Java 7 的 方法 句柄 ， 
但 大 多 数 开发 人 员 不 会 用 它 。 它 以 java.1ang.invoke.VarHandle 类 为 中 心 ， 该 类 的 实例 是 





对 变量 | 比如 字段 (但 不 限于 此 )] 的 强 类 型 引用 。 它 解决 了 反射 、 并 发 和 夫 


的 问题 。 与 反射 API 相 上 





上 ， 它 提供 了 更 多 的 类 型 安全 司 






































E 和 更 好 的 性 能 。 


外 数据 存储 等 领域 


方法 和 变量 句柄 是 通用 的 、 复 杂 的 特性 , 与 模块 系统 关系 不 大 , 因此 这 里 不 会 正式 介绍 它们 。 
如 果 你 偶尔 编写 使 用 反射 的 代码 , 那么 就 应 该 对 它们 进行 一 定 的 研究 ， 比 如 可 以 看 看 下 面 这 个 简 
单 示 例 ( 代码 清单 12-5 )。 但 是 ， 本 节 将 更 深入 地 讨论 一 个 特别 有 趣 的 方面 如何 使 用 变量 句柄 


来 访问 模块 的 内 部 。 
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代码 清单 12-5 ”使 用 varHangdle 访问 字段 值 


object object = // ... 给 定 一 个 对 象 及 其 字段 名 ……- 

string fieldName = // ... | |.。..。 这 是 典型 的 用 来 获得 
中 正安 届 处 证人 上 上 

Class<?> type = object.getClass(); 类 型 和 字段 的 反射 代码 


Field field = type.getDeclaredqField(fieldqName) : Lookup 和 VarHandle 是 方法 或 
变量 句柄 API 的 一 部 分 ， 它 们 都 
Lookup lookup = MethodHandles.1lookup(); 基于 lookup 技术 


VarHandle handle = lookup.unreflectVarHandle (field); 
handle.get (object); 


你 已 经 了 解 了 使 用 反射 API 要 求 用 户 开 放 一 些 依赖 包 , 但 是 反射 框架 无 法 在 代码 中 表达 这 一 
点 。 用 户 要 么 基于 对 模块 系统 的 了 解 而 获知 ， 要 么 必须 从 项 目 文档 中 学 习 ， 然 而 两 者 都 不 是 最 可 
靠 的 表达 需求 的 方式 。 如 果 框 架 代 码 可 以 让 这 一 切 变 得 更 清楚 ， 那 么 会 怎样 ? 

方法 和 变量 句柄 为 你 提供 了 这 样 的 工具 。 再 看 看 代码 清单 12-5， 参 见 MethoqHandles . 
lookup () 这 一 调用 。 它 创建 了 一 个 Lookup 实例 ， 该 实例 最 重要 的 作用 是 获得 了 调用 者 的 访问 
权限 〈 当然， 它 还 有 众多 其 他 作用 )。 

这 意味 着 所 有 包含 该 特定 1ookup 的 代码 ， 无 论 其 属于 哪个 模块 ， 都 可 以 在 与 创建 1ookup 
的 代码 相同 的 类 上 进行 深层 次 反射 ( 如 图 12-1 所 示 )。 这 样 ， 一 个 模块 可 以 捕获 对 其 内 部 组 件 的 
访问 权限 ， 并 将 其 传递 给 其 他 模块 。 

通过 reflected 模 块 ， 


所 有 内 部 的 类 都 可 
以 被 访问 
























reflected reflecting 











XY 





@ reflected 模 块 创建 @ reflected 模 块 将 @ reflecting 模 块 可 以 
了 一 个 Lookur Lookup 传 递 给 使 用 Lookup 访 问 
实例 reflecting 模 块 reflected 模 块 内 部 





图 12-1 reflected 模块 创建 一 个 Lookup 实例 并 将 其 传递 给 reflecting 模块 , 该 实例 可 用 于 访 
问 所 有 reflected 模块 能 访问 的 类 和 成 员 一 一 当然 也 包括 reflected 模块 内 部 


你 的 反射 代码 可 以 通过 要 求 用 户 将 lookup 对 象 传递 给 它 对 其 加 以 利用 , 例如 在 框架 启动 时 
提出 这 一 要 求 。 当 用 户 必须 调用 含有 一 个 或 多 个 Lookup 实例 的 方法 时 ， 他 们 必然 会 阅读 文档 ， 
了 解 应 该 做 的 事情 。 于 是 ,他们 在 每 个 需要 被 访问 的 模块 中 创建 一 个 Lookup 实例 ， 并 将 其 传递 
给 你 ， 然 后 你 就 可 以 使 用 它们 来 访问 模块 的 内 部 。 代 码 清 单 12-6 显示 了 这 一 过 程 的 工作 原理 。 
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代码 清单 12-6 使 用 VarHandle 通过 私有 的 lookup 访问 字段 值 
Lookup lookup = // ... 这 里 的 1ookup 是 创建 


Object object = // ... 阶 
String fieldName = // ... 在 模块 内 部 的 对 象 














Class<?> type = object .getClass() :; 
Field field = type.getDeclareqField(fieldqName) : 通过 基于 用 户 提供 的 类 型 创建 一 个 私 
有 的 lookup， 你 就 可 以 从 另 一 个 模 
Lookup privateLookup = MethodHandles a 
5 雍 天 久 内 癌 
.privateLookupIn (type,1lookup); 天 来 访问 该 对 象 的 内 部 


VarHandle handle = privateLookup.unreflectVarHandle (field); 
handle.get (object); 


lookup 的 有 趣 之 处 在 于 ， 它 们 可 以 在 两 个 模块 之 间 传 递 。 在 使 用 JPA 及 其 提供 者 进行 标准 
与 实现 分 离 的 情况 下 ， 用 户 可 以 将 所 有 的 1ookup 传递 给 JPA 的 引导 方法 ， 从 而 将 它们 传递 给 
Hibernate 、EclipseLink 等 。 这 是 一 种 非常 简洁 地 实现 lookup 的 方式 。 
口 用 户 意识 到 他 们 必须 采取 一 些 措 施 ， 因 为 引导 方法 依赖 于 Lookup 实例 ( 与 开放 式 包 相 
比 ， 其 不 能 在 代码 中 表示 其 需求 )。 
口 无 须 更 改 模块 声明 ( 与 opens 指令 不 同 )。 
口 标准 可 以 将 lookup 传递 给 实现 ， 因 此 不 会 强迫 用 户 在 代码 或 模块 声明 中 引用 实现 ( 如 

12.3.5 节 所 述 ， 这 对 于 开放 式 包 也 是 可 行 的 )。 

至 此 , 关于 使 用 反射 或 变量 句柄 来 访问 封装 在 模块 中 的 类 型 的 讨论 就 结束 了 。 现在， 本 章 将 

转向 模块 本 身 ， 看 看 能 获得 哪些 有 关 信 息 。 


12.3.3 ”通过 反射 分 析 模 块 属性 


如 果 曾 尝试 过 在 运行 时 分 析 JAR, 你 就 会 发 现 要 做 到 这 一 点 并 不 简单 。 这 可 以 追溯 到 对 JAR 
的 基本 解释 : 单纯 的 容器 (参见 1.2 草 。Java 无 法 将 它们 识别 为 像 包 和 类 型 那样 的 一 等 公民 ， 
因此 除了 一 个 普通 的 Zip 文 件 外 ， 其 在 运行 时 没有 任何 呈现 。 

模块 系统 的 关键 变化 是 使 Java 对 JAR 的 解释 与 人 们 认识 的 具有 名 称 、 依 赖 关 系 和 清晰 API 
的 代码 单元 保持 一 致 。 除 了 本 书 至 今 所 讨论 的 内 容 外 , 这 一 理念 还 应 该 延续 到 反射 API 之 中 : 模 
块 不 应 该 像 JAR， 而 应 该 与 包 和 类 型 一 样 ， 在 反射 API 中 有 所 呈现 。 事 实 上 确实 如 此 。 































































































定义 : Module 和 ModuleDescriptor 类 型 
Java9 引入 了 用 于 表示 运行 时 模块 的 新 类 型 java.lang.Module。 Module 实例 使 你 能 够 
做 到 以 下 几 点 : 
口 分 析 模 块 的 名 称 、 注 释 、 导 出 〈 开 放 ) 指令 和 服务 使 用 ; 
口 访 问 模块 包含 的 资源 (参见 5.2 次; 
口 通过 导出 和 开放 包 、 增 加 可 读 边 和 服务 使 用 来 修改 模块 (如 果 修 改 代 码 在 同一 模块 中 
的 话 )。 
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其 中 一 些 信息 仅 在 同样 为 新 类 型 的 java.lang.module.ModuleDescriptor 上 可 用 ， 


3 


并 返回 Module: :getDescriptor。 








获取 Module 实例 的 种 方法 是 在 任意 个 class 实例 上 调用 getModule (这 并 不 出 人 意 














料 )， 并 返回 该 类 所 属 的 模块 。 代 码 清单 12-7 和 代码 清单 12-8 展示 了 如 何 通 
ModuleDescriptor 来 分 析 模 块 ， 其 中 ， 后 者 展示 了 一 些 示 例 模 块 的 输出 。 


代码 清单 12-7 通过 查询 Module 和 ModuleDescriptor 来 分 析 模 块 


public static String describe(Module module) { 
String annotations = Arrays 
.Stream(module.getDeclaredAnnotations()) 
.map (Annotation::annotationType) 
.map (Object::toString) 
"ColLLeet tiolning ll, vy): 
ModuleDescriptor md = module.getDescriptor(); 
if (md == null) 
return "UNNAMED module { }"; 











return "" 

+ "@[" + annotations + "] \n" 
md.modifiers() + " module " + md.name() 
"@ " + toSstringl(md.rawVersion()) 
TN 
"\trequires " + md.requires() + "\n" 
"\texports " + md.exports() + "\n" 
"\topens " + md.opens() + "\n" 
"\tcontains " + md.packages() + "\n" 
"\tmain " + toString(md.mainClass()) + "\n" 
于 


二 十 十 十 十 十 十 十 十 


} 


private static String toString(Optional<?> optional) { 
return optional.isPresent() 
? optional.get () .toSstring() 
Wa py; 
} 


代码 清单 12-8 在 代码 清单 12-7 中 调用 describe (Module) 的 输出 


> @[] 

> [] module monitor @ [] { 

requires [ 
monitor.observer, 
monitor.rest 
monitor.persistence, 
monitor.observer.alpha, 
mandated java.base (@9.0.4), 
monitor.observer.beta, 
monitor.statistics] 

exports [] 

opens [] 


VV Vv Vv VV Vv VVvyV 


过 查询 Module 和 
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contains [monitor] 
main monitor.Main 
} 
@[] 
[] module monitor.persistence @ [] { 
requires [ 
hibernate.jpa, 
mandated java.base (@9.0.4), 
monitor.statistics] 
exports [monitor.persistencel 
opens [monitor.persistence.entity] 
contains [ 
monitor.persistence, 
monitor.persistence.entity] 
main [] 
} 
@[] 
[] module java.logging @ 9.0.4 { 
requires [mandated java.basel 
exports [java.util.loggingl] 
opens [] 
contains [ 
java.util.logging, 
sun.util.logging.internal, 
sun.net .www.protocol.http.logging, 
sun.util.logging.resources] 
main [] 
} 
@[] 
[] module java.base @ 9.0.4 { 
requires [] 
exports [... lots ...] 
opens [] 
ontalns [ss LOES a 
main [] 


Ve VV -YY MN WY WY WY VY NV VY YY YY Ea YY YY 


’ 


一 些 ModuleDescriptor 方法 返回 与 其 他 模块 相关 的 信息 ， 例 如 : 哪些 模块 是 必需 的 ， 哪 
些 模块 中 的 包 被 导出 和 开放 。 这 些 模块 名 称 只 是 普通 的 字符 串 ， 而 不 是 真实 的 Module 实例 。 然 
而 与 此 同时 , 许多 Module 的 方法 需要 这 样 的 实例 作为 输入 。 人 
需要 的 却 是 模块 实例 一 一 如 何在 这 一 鸿沟 上 架设 桥梁 ? 如 12.4.1 节 所 述 ， 答 案 是 层 。 


12.3.4 ”通过 反射 修改 模块 属性 


除了 分 析 模 块 的 属性 ， 还 可 以 使 用 Module 中 的 以 下 方法 来 修改 这 些 属性 。 
口 aqaqExports， 向 指定 模块 导出 一 个 包 。 
口 aqdqopens， 回 指定 模块 开放 一 个 包 。 
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口 addReads， 使 模块 可 以 读 取 另 一 个 模块 。 
口 adgUses， 让 模块 使 用 一 个 服务 。 

在 查看 这 些 内 容 时 ， 你 可 能 想 知 道 为 什么 可 以 导出 或 开放 模块 的 包 。 难 道 这 不 违背 强 封装 
吗 ? 因为 反射 代码 无 法 破解 , 所 以 12.2 节 整 节 都 在 讨论 模块 所 有 者 为 反射 准备 的 所 有 必需 的 事情 。 
难道 这 是 不 对 的 ? 


要 点 ”事情 是 这 样 的 : 这 些 方法 对 调用 者 敏感 (caller sensitive )， 这 意味 着 如 果 调 
短小 用 它们 的 代码 不 同 ， 它 们 的 表现 就 不 同 。 成 功 的 调用 要 么 来 自 正在 被 修改 的 模块 ， 
要 么 来 自 无 名 模块 。 其 他 情况 都 将 失败 并 且 抛 出 IllegalcallerException 异常 。 


以 下 面 的 代码 为 例 。 


public boolean openJavaLangTo(Module module) { 
Module base = Object.class.getModule(); 
base.addOpens ("java.lang", module); 
return base.isOpen("java.lang", module); 























da 








} 


如 有 果 将 其 复制 到 从 类 路 径 执 行 的 main 函数 ( 因此 它 在 无 名 模块 中 运行 ) 中 ， 则 可 以 正常 工 
作 , 并 且 该 方法 返回 true。 与 之 相反 , 如果 它 在 任何 具名 模块 ( 以 下 示例 中 的 open.up ) 中 运行 ， 
则 将 失败 。 
Exception in thread "main" java.lang.IllegalCallerException: 


> 
S java.lang is not open to module open.up 

SS at java.base/java.lang.Module.addOpens (Module.java:751) 
> 








at open.up/open.up.Main.openJavaLangTo (Main.java:18) 
at open.up/open.up.Main.main (Main.java:14) 


你 可 以 让 它 (再 次 ) 正常 工作 : 将 代码 注入 它 修改 的 模块 ( 本 例 中 即 java.base 模块 ) 中 ， 然 
后 使 用 --patch-module (参见 7.2.4 掀 。 


$ java 

--patch-module java.base=open.up.jar 

--module java.base/open.up.Main 
> WARNING: module-info.class ignored in patch: open.up.jar 
> true 


现在 你 明白 了 : 最 后 的 true 是 由 任意 平台 模块 调用 openJavaLangTo 产生 的 返回 值 。 

即使 你 正在 开发 基于 反射 的 框架 , 也 不 会 定期 动态 地 修改 自己 模块 的 属性 。 那么 为 什么 要 介 
绍 上 文中 的 一 切 ” 因为 下 文 将 介绍 这 里 隐藏 的 一 个 有 趣 细节 : 在 某 些 情况 下 , 可 以 开放 其 他 模块 
中 的 包 。 


12.3.5 ”转发 开放 式 包 


前 文 说 过 , 模块 只 能 通过 Module:addopens 开放 它 所 有 包 中 的 一 个 , 但 这 并 不 是 完全 正确 
的 。 如 果 某 个 模块 的 包 已 经 对 一 组 其 他 模块 开放 , 那么 上 述 所 有 模块 也 可 以 开放 该 包 。 换 名 话说 ， 
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具有 反射 访问 包 权限 的 模块 可 以 将 该 包 开 放 给 其 他 模块 。 这 意味 着 什么 ? 

再 想 一 下 JPA。 在 12.2.2 节 时 你 可 能 已 经 有 所 退缩 ， 因 为 在 JPA 的 情况 下 ， 看 起 来 好 像 需 要 
无 条 件 或 针对 需要 实际 反射 的 模块 开放 包 ， 这 意味 着 像 如 下 这 样 。 

module monitor.persistence { 


requires hibernate.jpa; 
requires monitor.statistics; 























exports monitor.persistence; 

// 假定 Hibernate 是 一 个 清晰 模块 

opens monitor.persistence.entity 
to hibernate.core; 


} 


开放 给 JPA 难道 不 比 开放 给 具体 的 实现 更 好 ? 这 就 是 具有 反射 访问 包 权 限 的 模块 得 以 开放 
给 其 他 模块 的 原因 。 这样，JPA 的 引导 代码 可 以 将 所 有 包 开 放 给 Hibernate， 即 使 其 中 那些 仅 具 有 
反射 访问 权限 的 包 也 是 如 此 。 

因此 ,尽管 只 有 模块 可 以 添加 导出 包 、 可 读 边 和 服务 使 用 ,但 开放 包 的 规则 放宽 了 ， 开 放 式 
包 的 所 有 模块 都 可 以 将 其 开放 给 其 他 模块 。 为 了 使 基于 反射 的 框架 能 够 利用 这 一 点 , 它们 当然 必 
须 了 解 模 块 系统 并 更 新 其 代码 。 但 是 就 JEE 技术 而 言 ， 这 可 能 还 需要 一 段 时 间 ， 除 非 Eclipse 在 
Jakarte EE 上 缩短 发 布 周期 (可 以 将 此 作为 参考 : 从 JavaSE8 到 JavaEE8 花 了 3 年 多 的 时 间 )。 

现在 本 章 已 经 解决 了 如 何 反 射 、 分 析 和 修改 单个 模块 的 问题 ， 可 以 进入 下 一 层 (layer ) 了 ， 
下 一 节 将 介绍 这 一 概念 ， 以 及 它 在 整个 模块 图 中 的 应 用 。 


12.4 动态 创建 市 有 层 的 模块 图 


12.3 节 重 点 介绍 了 单独 的 模块 : 如 何 反射 模块 化 代码 , 以 及 如 何 分 析 和 修改 单个 模块 的 属性 。 
本 市 扩大 了 范围 ， 将 介绍 整个 模块 图 。 

到 目前 为 止 ， 人 们 已 经 将 模块 图 的 创建 工作 交 给 了 编译 器 或 JVM， 后 者 将 在 开始 工作 之 前 
生成 它们 。 生 成 之 后 ， 模 块 图 就 是 几乎 完全 不 变 的 实体 ， 无 法 提供 添加 或 删除 模块 的 方法 。 

尽管 这 对 于 许多 常规 应 用 程序 来 说 没有 问题 , 但 是 有 些 应 用 程序 需要 更 大 的 灵活 性 。 以 应 用 
程序 服务 器 或 基于 插件 的 应 用 程序 为 例 , 它们 需要 一 种 动态 机 制 ,以 方便 在 运行 时 动态 加 载 和 种 
载 类 。 

例如 ， 假 设 ServiceMonitor 应 用 程序 提供 了 一 个 终端 或 图 形 界面 ， 以 方便 用 户 指定 额外 需要 
观察 的 服务 。 这 可 以 通过 实例 化 合适 的 serviceobservet 实现 来 完成 , 但 是 如 果 该 实现 来 自 一 
个 启动 时 未 知 的 模块 怎么 办 ? 它 〈 以 及 它 的 依赖 ) 必须 能 够 在 运行 时 被 动态 加 载 。 

在 模块 系统 出 现 之 前 , 这 样 的 容器 应 用 程序 通过 原生 类 加 载 器 进行 动态 加 载 和 外 载 。 但 是 如 
果 它 们 像 编 译 器 和 JVM 一 样 ， 也 可 以 进入 更 高 的 抽象 级 别 并 在 模块 上 运行 ， 那 不 是 很 好 吗 ? 幸 
好 ,模块 系统 通过 引入 层 (layer ) 的 概念 就 可 以 做 到 这 一 点 。 你 需要 做 的 第 一 件 事 是 了 解 层 , 包 
括 一 直 不 知 不 觉 在 使 用 的 层 (参见 12.4.1 节 )。 下 一 步 是 分 析 层 ( 参见 12.4.2 节 )， 然 后 是 在 运行 
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时 动态 创建 自己 的 层 (参见 12.4.3 欧 。 

请 注意 , 编写 处 理 层 的 代码 其 至 比 使 用 反射 API 还 少见 。 以 下 是 一 个 简单 快捷 、 一 目 了 然 的 
检验 方法 : 如 果 你 从 未 实例 化 过 类 加 载 器 ， 则 不 太 可 能 在 不 久 的 将 来 使 用 到 层 。 因 此 ， 本 节 为 你 
提供 了 与 它 相 关 的 知识 框架 , 方便 读者 了 解 学 习 的 方向 , 但 不 会 进行 详细 讲解 。 不 论 怎么 说 ,你 
都 会 看 到 一 些 之 前 认为 不 可 能 的 事物 ， 并 最 终 得 到 一 些 新 的 想法 。 








12.4.1 什么 是 层 


定义 : 模块 层 

模块 层 (module layer ) 包括 具名 模块 的 完全 解析 图 ， 以 及 用 于 加 载 模块 中 类 的 ( 所 有 ) 
类 加 载 器 。 每 个 类 加 载 器 都 有 一 个 与 之 关联 的 无 名 模块 ( 通过 ClassLoader: :getUnnamed- 
Module 访问 )。 层 还 引用 了 一 个 或 多 个 父 层 ( parent layer )。 层 中 的 模块 可 以 读 取 其 祖先 层 中 
的 模块 ， 但 不 能 反 过 来 。 


到 目前 为 止 ， 本 书 讨论 的 所 有 与 模块 之 间 的 解析 和 关系 相关 的 内 容 都 发 生 在 单个 模块 图 中 。 
借助 层 ， 人 们 可 以 根据 需要 堆 县 任意 数量 的 图 ， 因 此 从 概念 上 讲 ， 层 为 二 维 概念 的 模块 网 增加 了 
三 维 的 解释 。 父 层 在 创建 层 时 定义 ， 创 建 后 不 允许 更 改 ， 因 此 没有 创建 循环 层 的 方法 。 图 12-2 
展示 了 带 有 层 的 模块 图 。 
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4 模块 间 的 关系 可 以 
从 顶部 到 底部 形成 
( | 一 个 循环 


pS 


模块 间 的 关系 
可 以 穿 过 层 

















最 基本 的 层 是 平台 模块 
图 12-2 ”通过 层 可 以 堆 友 模 块 图 ， 并 为 应 用 程序 增加 三 维 模型 。 由 于 它们 不 共享 类 加 载 器 ， 因 此 
各 层 之 间 的 隔离 度 很 好 ( 就 像 每 一 个 好 的 计算 机 科学 图 一 样 ， 只 不 过 这 个 看 起 来 可 能 是 
颠倒 的 。 父 层 位 于 其 子 层 之 下 ， 因 此 包含 平台 模块 的 层 位 于 最 底部 ) 
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在 ServiceMonitor 中 ,这 意味 着 要 动态 加 载 新 的 观察 者 实现 ,因此 就 需要 创建 一 个 新 层 ,12.4.3 
节 将 讨论 这 一 点 。 在 此 之 前 ， 先 仔细 研究 一 下 现 有 的 层 以 及 如 何 分 析 它 们 。 
所 有 模块 都 包含 在 某 个 层 中 吗 ? 差不多 。 如 上 文 所 述 ， 从 技术 上 讲 ， 无 名 模块 不 在 其 中 。 还 


有 所 谓 的 动态 模块 ， 其 不 一 定 非 要 属于 某 个 层 ， 但 本 书 不 涉及 这 种 模块 除了 这 些 ， 所 有 模块 者 
属于 某 个 层 。 














启动 层 
那么 贯穿 于 本 书 图 中 的 所 有 应 用 程序 模块 和 平台 模块 呢 ? 它们 也 应 该 属于 某 个 层 ， 对 吧 ? 








定义 : 启动 层 
应 用 程序 模块 和 平台 模块 确实 属于 同一 层 。 启 动 时 ，JVM 创建 一 个 初始 层 ， 即 启动 层 ， 
其 包含 根据 命令 行 选项 解析 的 应 用 程序 模块 和 平台 模块 。 


启动 层 没 有 父 层 ， 它 包含 3 个 类 加 载 器 。 

口 启动 类 加 载 器 为 加 载 的 所 有 类 赋予 全 部 安全 权限 ， 所 以 JDK 团队 尽 最 大 努力 减少 其 负责 

的 模块 。 这 是 一 些 核心 平台 模块 ， 主 要 是 java.base 模块 。 

口 平 台 类 加 载 器 从 所 有 其 他 平台 模块 加 载 类 ， 可 以 使 用 静态 方法 classLoader:: 

getPlatformclassLoader 来 访问 。 

口 系统 或 应 用 程序 类 加 载 器 从 模块 和 类 路 径 中 加 载 所 有 类 ， 意 味 着 它 负责 所 有 应 用 程序 模 
块 ， 可 以 使 用 静态 方法 ClassLoader: :getSystemClassLoader 访问 。 

因为 只 有 系统 类 加 载 器 可 以 访问 类 路 径 , 所 以 在 这 3 个 加 载 器 中 ， 只 有 系统 类 加 载 器 的 无 名 

模块 是 非 空 的 。 因 此 8.2 节 在 讨论 无 名 模块 时 总 是 引用 系统 类 加 载 需 。 

如 图 12-3 所 示 ， 类 加 载 器 不 是 孤立 的 : 每 个 类 加 载 器 都 有 一 个 父 加 载 器 ， 而 且 大 多 数 类 加 
载 锅 的 实现 (包括 刚才 提 到 的 3 个 ) 在 尝试 自己 查找 类 之 前 ， 首 先 会 要 求 父 加 载 器 加 载 类 。 至 于 
3 个 启动 层 中 的 类 加 载 器 ， 启 动 类 加 载 右 没有 父 加 载 器 ， 平台 加 载 右 委托 给 了 启动 加 载 嚣 ， 系 统 
加 载 器 委托 给 了 平台 加 载 器 。 因 此 , 系统 类 加 载 锅 可 以 从 启动 加 载 器 和 平台 加 载 器 访问 所 有 应 用 
程序 和 JDK 类 。 














从 模块 路 径 和 类 路 径 加 载 未 被 启动 类 加 载 器 只 加 载 最 基本 的 平台 模块 ， 
加载 加 载 的 平台 模块 并 赋 了 予 所 有 的 安全 权限 


System | delegates [| Platform | delegates Boot 
class “| 一 人 class “| 一 > class 
loader loader loader 

尼 1 动 层 


图 12-3 ”启动 层 中 3 个 类 加 载 右 之 间 的 委托 
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12.4.2 分析 模块 层 


定义 : ModuleLayer 
在 运行 时 ， 层 通过 java .lang .ModuleLayer 实例 星 现 ， 利 用 它 可 以 查询 层 所 包含 的 以 
下 3 个 因素 。 
口 模块 。 
加 modules () 方 法 以 Set<Module> 的 形式 返回 该 层 包 含 的 模块 。 
和 四 findModule (String) 方 法 在 该 层 以 及 它 的 所 有 祖先 层 中 查找 具有 特定 名 称 的 模块 。 
因为 有 可 能 无 法 找到 该 模块 ， 所 以 它 返 回 一 个 Optional<Module>。 
口 parent () 方 法 以 List<ModuleLayer> 的 形式 返回 该 层 的 父 模块 层 。 
口 每 个 模块 的 类 加 载 器 可 以 通过 用 模块 名 调用 findLoader (String) 的 方式 确定 。 
然后 是 configuration 方法 , 它 返 回 一 个 Configuration 实例 ,更 多 信息 参见 12.4.3 节 。 








要 获得 一 个 ModuleLayer 实例 ， 可 以 从 任意 模块 获得 其 所 属 的 层 。 





CLass<?>. tyDe SS// vos 任意 类 
ModuleLayer layer = type 
.getModule() 
.getLayer (); 























如 果 类 型 来 自 无 名 模块 或 不 属于 某 个 层 的 动态 模块 ， 最 后 一 行 就 返回 nul1; 如 果 和 希望 访问 
启动 屋 ， 则 可 以 调用 静态 方法 ModuleLayer: :boot。 

那么 ，ModuleLayer 实例 有 什么 用 呢 ? 毫 无 疑问 ,最 有 趣 的 是 modaules() 和 findqModule 
(String) 方 法 ， 因 为 与 模块 上 的 方法 相 结 合 (参见 12.3.3 节 )， 它 们 可 以 遍历 和 分 析 模块 图 。 














1. 描述 模块 层 
使 用 代码 清单 12-7 中 的 gescribe (Module) 方 法 ， 可 以 这 样 描述 整个 层 。 


private static String describe(ModuleLayer layer) { 
return layer 
.modules () .stream() 
.map (ThisClass: :describe) 
.collect (joining("\n\n")); 





2. 在 层 内 和 层 间 查 找 模块 

确定 特定 模块 是 否 存 在 ， 对 于 可 选 依赖 是 非常 有 用 的 (通过 requires static 指令 ,参见 
11.2 欧 。11.2.4 节 曾 提 到 过 可 以 通过 简单 地 实现 isModulePresent (String) 方 法 来 达到 这 个 
目的 。 这 样 可 以 把 到 目前 为 止 学 到 的 与 层 相 关 的 知识 付 诸 实践 ， 所 以 请 一 步 步 实 现 。 

起 初 ， 这 似乎 很 简单 。 
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public boolean isModulePresent (String moduleName) { 
return ModuleLayer 
.boot () 
.findModule (moduleName) 
.isPresent (); 


} 


这 只 是 验证 模块 是 否 在 启动 层 中 , 而 如 果 创 建 了 其 他 层 , 并 且 模 块 在 男 一 个 层 中 该 怎么 办 ? 
可 以 用 包含 isModulePresent 的 层 替 换 启 动 层 。 


public boolean isModulePresent (String moduleName) { 
return searchRootModuleLayer () 
.findModule (moduleName) 
.isPresent (); 








} 


private ModuleLayer searchRootModuleLayer() { 
return this 
.getClass() 
.getModule () 
-getLayer(); 
} 


通过 这 种 方式 ，isModulePresent 将 搜索 自己 所 在 的 层 ( 可 以 称 之 为 search 层 ) 和 其 所 
有 祖先 层 。 但 这 还 不 够 ,调用 该 方法 的 模块 可 能 在 男 一 个 名 为 cal1l 的 层 中 ， 该 层 的 祖先 层 是 
search 层 (困惑 吗 ? 如 图 12-4 所 示 )。 这样 一 来 ，search 就 不 能 查找 call 层 , 不 能 搜索 所 有 
可 能 的 模块 。 你 需要 caller 的 模块 将 其 层 用 作 你 搜索 的 根 。 








:在 寻找 这 个 ? 











从 自己 所 在 
i 搜 索 ， 则 只 能 
己 所 在 的 层 以 及 



























































图 12-4 要求 查找 模块 的 层 只 扫描 自己 所 属 的 层 及 其 父 层 ( 在 图 中 是 向 下 的 )。 因 此 ， 如 果 
search 查询 自己 所 属 的 层 ， 那么 它 可 能 会 忽略 caller 模块 〈 发 起 查找 的 模块 ) 可 以 
看 到 的 层 ， 因 此 存在 返回 错误 结果 的 风险 ， 这 就 是 为 什么 查询 call 所 在 的 层 很 重要 
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代码 清单 12-9 实现 了 getcallerclass， 其 使 用 Java 9 引入 的 stack-walking API 来 确定 
caller 的 类 。 


代码 清单 12-9 用 于 过 历 调用 栈 的 新 API 


private Class<?> getCallerClass() { 获取 stackWalker 实例 的 静 
return StackWalker 态 工厂 方法 , 其 中 每 个 frame 
.getInstance (RETAIN_CLASS_REFERENCE) 所 都 有 一 个 对 声明 类 的 引用 


意 对 象 的 函数 。 它 为 栈 创建 了 一 个 延迟 视图 ， 并 通过 它 立 即 
调用 该 函数 。 该 函数 返回 的 对 象 随后 由 walk 返回 
frame.getDeclaringClass() != this.getClass()) 

> .findFirst() 


> .filter(frame -> 


.walk (stack -> stack 
walk 期 望 传 入 一 个 能 将 Stream <StackFrame> 转 换 成 任 





.map (StackFrame: :getDeclaringClass) 十 4 /日 
| 得 类 
.orElseThrow(IllegalStateException::new) Bp 如 果 不 存在 这 样 的 frame 
) 字 2 
} 那 就 太 奇 怪 了 …… 


你 对 来 自 另外 一 个 类 (一定 是 caller, 而 非 这 
一 个 ) 的 第 一 个 frame 感 兴趣 ， 现 在 你 有 了 一 


个 optional<StackFrame> 


有 了 这 个 工具 箱 ， 你 就 拥有 了 caller 的 模块 。 


public boolean isModulePresent (String moduleName) { 
return searchRootModuleLayer () 
.findModule (moduleName) 
.isPresent (); 


} 


private ModuleLayer searchRootModuleLayer() { 
return getCallerClass() 
.getModule () 
.getLayer(); 
} 


这 是 用 来 分 析 模 块 层 的 。 现在 本 方 终于 可 以 进入 最 令 人 兴奋 的 部 分 了 : 通过 创建 新 层 将 新 代 
码 加 载 到 正在 运行 的 应 用 程序 中 。 

















12.4.3 ”创建 模块 层 


只 有 一 小 部 分 用 Java 编写 的 应 用 程序 需要 在 运行 时 动态 加 载 代 码 ， 同 时 这 些 代码 也 是 比较 
重要 的 。 而 最 有 名 的 例子 是 Eclipse， 它 专注 于 插件 ; 像 WildFly 和 GlassFish 这 样 的 应 用 服务 器 ， 
必须 同时 加 载 一 个 或 多 个 来 自 应 用 程序 的 代码 。 正 如 15.3.2 节 将 讨论 的 ，OSGi 还 能 够 动态 地 加 
载 和 仓 载 bundle (模块 的 别名 )。 
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在 加 载 插件 、 应 用 程序 、bundle 和 其 他 运行 JVM 新 片段 的 机 制 方面 , 它们 有 相同 的 基本 要 求 。 
口 必须 能 够 在 运行 时 从 一 组 JAR 中 启动 一 个 片段 。 
口 必须 能 够 与 加 载 的 片段 交互 。 
口 必须 能 够 将 不 同 的 片段 隔离 。 

在 模块 系统 出 现 之 前 ， 这 是 通过 类 加 载 器 完成 的 。 人 简单 来 说 就 是 为 新 JAR 创建 一 个 新 的 类 
加 载 右 。 它 被 委托 给 男 一 个 类 加 载 右 ( 比如 系统 类 加 载 右 )， 这 样 就 可 以 访问 正在 运行 的 JVM 中 
的 其 他 类 了 。 虽然 每 个 类 ( 由 其 完全 限定 名 标识 ) 在 每 个 类 加 载 器 中 只 能 存在 一 次 , 但 它 可 以 很 
容易 地 由 多 个 加 载 器 加 载 。 这 样 就 隔离 了 片段 ,并 为 每 个 片段 提供 了 维护 自己 的 依赖 而 不 与 其 他 
片段 产生 冲突 的 可 能 性 。 

模块 系统 没有 以 任何 方式 改变 这 一 点 。 保 持 现 有 的 类 加 载 器 层次 结构 不 变 是 在 类 加 载 器 之 下 
实现 模块 系统 的 动因 之 一 (参见 15.3.2 节 )。 模 块 系统 增加 的 是 围绕 类 加 载 器 的 层 概念 ， 其 支持 
在 启动 时 与 加 载 的 模块 进行 集成 。 下 面 看 看 如 何 创建 模块 层 ( 可 以 在 ServiceMonitor 应 用 的 
feature-layers 分 支 中 找到 创建 层 的 例子 )。 


1. 创建 配置 

ModuleLayer 的 一 个 重要 组 成 部 分 是 configuration, 创建 它 将 触发 模块 解析 过 程 ( 参见 
3.4.1 节 )， 而 所 创建 的 实例 表示 一 个 得 到 成 功 解析 的 模块 图 。 创 建 configuration 的 最 基本 形 
式 是 使 用 静态 工厂 方法 ， 即 resolve 和 resolveandqBindq。 两 者 之 间 唯 一 的 区 别 是 ， 后 者 绑 定 
服务 (参见 10.2.2 节 )， 而 前 者 不 绑 定 服务 。 

resolve 和 resolveAndBind 使 用 了 4 个 相同 的 参数 。 

口 在 查看 父 配 置 之 前 ， 使 用 ModuleFinder before 定位 模块 。 
DQ List<Configuration> parents 是 父 层 的 配置 。 

口 在 查看 父 配置 后 ， 使 用 ModuleFinder after 定位 模块 。 

口 collection<String> roots 是 解析 过 程 的 根 模块 。 

为 模块 路 径 创建 ModuleFinder 与 调用 MoGduleFinder .of (Path...) 一 样 简单 。 尝 试 从 
父 层 引 用 尽 可 能 多 的 模块 是 很 常见 的 ，pbefore 查找 器 在 创建 时 通常 没有 参数 ， 因 此 也 就 无 法 找 
到 任何 模块 。 

在 创建 单个 父 加 载 器 配置 的 常见 情况 下 , 调用 实例 的 resolve 和 resolveAndBing 方法 
会 更 容易 。 它 们 没有 List<Cconfiguration> parents 参数 ， 使 用 当前 配置 作为 父 加 载 器 的 
配置 。 

假设 要 创建 一 个 以 启动 层 为 父 层 的 配置 , 该 配置 模拟 启动 命令 java --module-path mods 
--module root ， 但 不 需要 服务 绑 定 。 为 此 ， 可 以 在 启动 层 的 配置 (使 其 成 为 父 配置 ) 上 调用 
resolve 方法 (这样 不 会 绑 定 服务 )， 并 传递 一 个 模块 查找 器 ， 该 模块 查找 器 将 查看 mods 目录 。 
代码 清单 12-10 创建 了 这 样 的 一 个 配置 ， 并 模拟 了 java --module-path mods --module 
initial (不 包含 服务 绑 定 )。 
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代码 清单 12-10 模拟 java --module-path mods --module 


在 查看 父 层 模 块 图 之 如 果 模 块 不 在 父 层 模块 图 ， 那 
前 无 须 查找 模块 么 查找 器 将 查找 mods 目录 
ModuleFinder emptyBefore = ModuleFinder.of(); 





ModuleFinder modulePath = ModuleFinder.of (Paths.get ("mods")); 
Configuration bootGraph = ModuleLayer.boot() .configuration(); 
Configuration graph = bootGraph #C 

.resolve (emptyBefore, modulePath, List.of("initial")); 


通过 调用 resolve 将 启动 层 的 配置 定义 为 
父 层 (resolveAndBind 将 绑 定 服务 ) 








下 一 个 示例 ， 让 我 们 回 到 希望 ServiceMonitor 在 运行 时 观察 新 服务 的 场景 。 为 此 ， 需 要 加 载 
新 的 ServiceObserver 实现 。 第 一 步 , 创建 一 个 配置 , 将 当前 层 作为 父 展 ,查找 指定 路 径 上 的 
模块 。 

因为 你 在 服务 中 将 使 用 模块 系统 的 服务 ， 所 以 调用 resolveandBind 方法 。 你 可 以 仅 依赖 
该 机 制 来 查找 所 需 的 所 有 模块 ( 及 其 依赖 项 )， 因 此 无 须 指 定 根 模块 。 代 码 清单 12-11 中 是 实现 。 


代码 清单 12-11 从 指定 路 径 绑 定 所 有 模块 的 配置 


private static Configuration createConfiguration(Path[] modulePaths) { 


























return getThisLayer() -十 
返回 类 createconfiguration 
.configuration() 所 属 的 层 
.resolveAndBind( 本 





ModuleFinder.of(), 
ModuleFinder.of (modulePaths), 
Collections.emptyList() 3 





调用 ， 以 便 解析 服务 


你 依赖 服务 绑 定 来 完成 工作 
并 获取 所 需 的 模块 ， 因 此 不 
需要 定义 根 模块 





2. 创建 ModuleLayer 
如 12.4.1 节 所 述 ， 层 由 模块 图 、 类 加 载 器 和 对 父 层 的 引用 组 成 。 创 建 模块 的 基本 形式 是 使 用 


静态 方法 defineModules (Configuration、List<ModuleLayer> 和 Function<String， 





























ClassLoader>)。 
口 你 已 经 知道 如 何 获得 configuration 实例 。 
口 List<ModuleLayer> 是 父 层 。 
口 Function<String，ClassLoader> 将 每 个 模块 名 映射 到 你 希望 负责 该 模块 的 类 加 载 
船上 。 
该 方法 返回 一 个 controller， 其 可 以 通过 添加 读 取 边 或 在 调用 1ayer () 之 前 导出 (或 开 
放 ) 包 来 进一步 编辑 模块 图 。 layer () 返回 ModuleLayero 
你 可 以 调用 defineModules 的 几 个 变 体 方 法 。 
口 defineModulesWithoneLoader 对 所 有 模块 都 使 用 单个 类 加 载 器 。 作 为 方法 参数 给 出 
的 类 加 载 器 成 了 父 加 载 需 。 
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口 defineModulesWithManyLoaders 为 每 个 模块 使 用 一 个 单独 的 类 加 载 器 。 作 为 方法 参 
数 给 出 的 类 加 载 器 是 每 个 加 载 器 的 父 加 载 需 。 
口 每 个 方法 都 有 一 个 变 体 , 该 变 体 可 以 在 ModauleLaye 的 一 个 实例 上 调用 , 并 使 用 该 实例 
作为 父 屋 。 它 们 返回 创建 的 屋 ， 而 不 是 controller。 
继续 探索 动态 加 载 Serviceobserver 的 实现 , 下 一 步 是 根据 配置 创建 实际 的 层 。 这 非常 简 
单 ， 如 代码 清单 12-12 所 示 。 


代码 清单 12-12 ”根据 配置 创建 层 
创建 如 代码 清单 12-11 所 示 的 configuration getThisLoader 会 返回 加 载 
createLayer 的 类 加 载 器 


private static ModuleLayer createLayer (Path[] modulePaths) { 
Configuration configuration = createConfiguration(modulePaths); 






































ClassLoader thisLoader = getThisLoader(); 4 
return getThisLayer() 
.defineModulesWithOneLoader (configuration, thisLoader); < 
: 只 想 此 层 所 有 模块 的 单一 加 载 器 为 父 加 载 器 , 所 
与 代码 清单 12-11 中 的 getThisLayer 相同 以 调用 defineModulesWithoneLoader 方法 


最 后 一 步 ， 检 查 新 创建 的 层 是 否 包 含 一 个 可 以 处 理 需 要 观察 的 服务 的 ServiceObserver。 
为 此 ， 可 以 使 用 serviceLoagder: :1oad 的 重 载 方法 ， 其 除了 所 查找 的 服务 类 型 之 外 ， 还 需要 
一 个 MoguleLayer。 这 里 语义 应 该 是 清晰 的 : 在 定位 提供 者 时 查看 该 层 ( 及 其 祖先 层 )， 如 代码 
清单 12-13 所 示 。 


代码 清单 12-13 ”在 新 层 中 发 现 服 务 提 供 者 ( 及 其 祖先 ) 


private static void registerNewServicel( 























i 
String serviceName, Path... modulePaths) { 创建 如 代码 清单 12-12 

ModuleLayer layer = createLayer (modulePaths); < 所 示 的 层 

Stream<ServiceObserverFactory> observerFactories = ServiceLoader 


一 一 上 .1oad(1ayer，ServiceObserverFactory.class) .stream() 

.map (Provider: :get); 

Optional<ServiceObserver> observer = observerFactories 
.map (factory -> factory 

.createIfMatchingService(serviceName)) 

.flatMap (Optional::stream) 
.findFirst(); 

observer.ifPpresent (monitor: :addServiceObserver); 





} 





使 用 接受 新 层 的 serviceLoader: :load 剩 下 的 就 是 像 往常 一 样 为 serviceName 
变 体 寻找 一 个 观察 者 








如 果 上 面 做 的 还 不 够 ， 这 里 还 有 一 些 人 们 很 少 涉及 的 事情 ， 则 可 以 通过 模块 层 来 实现 。 

口 创建 有 多 个 父 层 或 类 加 载 圳 的 配置 和 层 。 

口 使 用 层 来 加 载 同一 模块 的 多 个 版 本 。 

口 使 用 controller 修改 模块 图 ( 例如 ,导出 或 开放 模块 ), 然 后 将 其 转换 为 ModuleLayer。 
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口 直接 从 创建 的 层 中 加 载 特定 的 类 作为 片段 的 入 口 点 ， 而 不 是 使 用 JPMS 服务 。 
可 以 通过 Javadoc，, 特别 是 ModuleLayer 和 configuration,， 了解 更 多 的 相关 方法 。 或 者 
翻 到 13.3 方 ， 其 中 有 利用 了 这 些 特性 的 例子 。 























12.5 小结 


口 代码 反射 所 针对 的 模块 。 

大 多 数 情况 下 ，exports 指令 并 不 适用 于 使 类 可 被 反射 访问 ， 因 为 在 基于 反射 的 框架 
中 使 用 的 类 很 少 适合 作为 模块 公有 API 的 一 部 分 。 在 使 用 合 规 导出 时 ， 你 可 能 被 迫 将 
模块 绑 定 到 实现 而 非 标 准 。 导 出 不 支持 对 非 私 有 字段 和 方法 进行 深度 反射 。 

@ 默认 情况 下 ， 不 应 该 使 用 exports 指令 ， 而 应 该 使 用 opens 指令 来 开放 用 于 反射 的 包 。 

和 opens 指令 的 语法 与 exports 指令 相同 , 但 两 者 工作 方式 不 同 : 开放 的 包 在 编译 时 不 
可 访问 ， 但 所 有 类 型 和 成 员 (包括 非 公 有 类 型 和 成 员 ) 都 可 以 在 运行 时 访问 。 这 些 属 
性 与 基于 反射 的 框架 的 需求 密切 相关 ， 这 使 得 在 准备 用 于 反射 的 模块 时 ，opens 指令 
成 了 默认 的 选择 。 

四 合 规 变 体 opens . . .to 为 具名 模块 开放 了 一 个 包 。 因 为 通常 哪些 框架 反射 了 哪些 包 
是 显而易见 的 ， 所 以 合 规 的 open 指令 能 否 带 来 很 多 价值 非常 值得 怀疑 。 

四 如 果 反 射 框架 被 划分 为 标准 及 其 实现 (就 像 JPA 和 Hibernate、EclipseLink 等 )， 那么 在 
技术 上 可 以 只 向 标准 开放 一 个 包 ， 然 后 该 标准 可 以 使 用 反射 API 将 其 开放 到 一 个 特定 
的 实现 。 但 是 ， 这 还 没有 得 到 广泛 实现 ， 所 以 目前 合 规 开放 需要 命名 特定 的 实现 模块 。 

和 命 今 行 选项 --add-opens 与 --add-exports 具有 相同 的 语法 ， 其 工作 方式 类 似 于 合 
规 开 放 。 在 迁移 到 Java9 及 以 上 版 本 期 间 , 在 命令 行 中 开放 平台 模块 以 访问 内 部 结构 是 
很 常见 的 ,但 是 如 果 有 必要 的 话 ， 它 也 可 以 用 来 进入 其 应 用 程序 的 模块 。 

昌 如 果 使 用 open module ( 而 不 仅仅 是 module ) 声明 一 个 模块 ， 那 么 该 模块 中 的 所 有 
包 都 会 被 开放 。 如 果 一 个 模块 包含 许多 需要 开放 的 包 ， 那 么 这 是 一 个 很 好 的 解决 方案 ， 
但 是 应 该 仔细 评估 这 是 否 真 的 有 必要 ,或 者 是 否 可 以 补救 。 理 想 情 况 下 ， 在 将 模块 重 
构 为 更 干净 的 状态 (公开 更 少 的 内 部 信息 ) 之 前 ，open module 通常 在 模块 化 过 程 中 

使 用 。 
口 针对 模块 进行 反射 的 代码 。 

@ 反射 受到 与 常规 代码 相同 的 可 访问 性 规则 的 约束 。 在 必须 读 取 所 访问 的 模块 时 ， 反 射 
API 可 以 隐 式 地 添加 一 条 读 取 边 , 使 事情 变 得 更 简单 。 在 导出 或 开放 包 时 ,如果 模 块 所 
有 者 没有 为 此 准备 模块 ， 那 么 反射 代码 的 作者 对 此 将 无 能 为 力 ( 唯一 的 解决 方案 是 使 
用 --add-opens 命令 行 选项 )。 

上 四 这 使 得 向 用 户 介绍 强 封装 以 及 模块 需要 访问 哪些 包 变 得 更 加 必要 。 可 以 采取 的 措施 包 

括 好 好 编写 文档 以 及 使 源 代码 易于 获得 。 
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和 确保 正确 处 理 因 强 封装 而 抛 出 的 异常 ， 这 样 就 可 以 向 用 户 提 供 信 息 丰 富 的 错误 消息 ， 
可 能 还 会 链接 到 对 应 的 文档 。 

四 考虑 使 用 变量 句柄 而 不 是 反射 API。 变量 句柄 提供 了 更 多 的 类 型 安全 性 , 性 能 更 好 , 并 
通过 Lookup 实例 提供 了 在 引导 API 中 表达 访问 需求 的 方法 。 

和 Lookup 实例 为 每 个 人 提供 了 与 创建 它 的 模块 相同 的 可 访问 性 。 因 此 ， 当 用 户 在 他 们 的 
模块 中 创建 一 个 Lookup 实例 并 将 其 传递 给 框架 时 ， 你 可 以 访问 其 模块 内 部 。 

四 新 类 Module 和 ModuleDescriptor 是 反射 API 的 一 部 分 , 可 以 访问 关于 模块 的 所 有 
信息 ， 比 如 名 称 、 依 赖 项 以 及 导出 或 开放 的 包 。 它 可 以 在 运行 时 用 来 分 析 实 际 的 模块 
图 。 

四 通过 使 用 该 API, 模块 还 可 以 修改 自己 的 属性 、 得 到 导出 或 开放 包 , 或 将 读 取 边 添加 到 
其 他 模块 。 通 常 ， 修 改 其 他 模块 是 不 可 能 的 ， 但 是 如 果 一 个 模块 向 另 一 个 模块 开放 了 
自身 的 包 ， 那 么 后 者 就 可 以 将 该 包 向 第 三 个 模块 开放 。 

口 动态 加 载 模块 的 代码 。 

@ 类 加 载 器 是 将 代码 动态 加 载 到 正在 运行 的 程序 中 的 方法 。 这 在 模块 系统 中 没有 改变 ， 
但 是 确实 提供 了 一 个 带 层 的 类 加 载 器 的 模块 化 包装 。 层 封装 类 加 载 器 和 模块 图 ， 创 建 
模块 图 将 加 载 的 模块 ， 暴 露 给 模块 系统 提供 的 所 有 一 致 性 检查 和 可 访问 性 规则 。 因 此 ， 
层 可 以 用 来 为 加 载 的 模块 提供 可 靠 配 置 和 强 封装 。 

四 启动 时 ，JVM 创建 启动 层 。 启 动 层 由 3 个 类 加 载 器 和 所 有 最 初 解析 的 平台 以 及 应 用 程 
序 模块 组 成 。 可 以 使 用 静态 方法 ModuleLayer: :boot 访问 ， 返 回 的 ModuleLayer 
实例 可 用 于 分 析 整 个 模块 图 。 










































































模块 版 本 : 可 能 和 不 可 能 








本 章 内 容 

口 为 什么 模块 系统 不 处 理 版 本 信息 
口 记录 版 本 信息 

口 在 运行 时 分 析 版 本 信息 

口 加 载 模块 的 多 个 版 本 








正如 1.6.6 节 简 要 提 到 的 ，JPMS 不 支持 模块 版 本 ,但 是 jar --module-version 有 什么 用 
呢 ? 12.3.3 节 不 是 说 明了 ModuleDescriptor 至 少 可 以 报告 模块 的 版 本 吗 ? 本 章 澄 清 了 这 些 问 
题 ， 并 从 几 个 不 同 的 角度 来 看 待 模块 版 本 。 

本 章 将 首先 讨论 模块 系统 以 哪 种 方式 支持 版 本 以 及 为 什么 不 支持 版 本 (参见 13.1 前 。 然 后 
介绍 模块 系统 允许 人 们 记录 和 评估 版 本 信息 (参见 13.2 区 。 最 后 展示 一 个 必 杀 技 ( Holy Grail ): 
运行 同一 个 模块 的 不 同 版 本 (参见 13.3 节 )。 虽 然 没 有 原生 的 支持 ， 但 是 通过 一 些 努力 仍 可 以 实 
现 间接 的 支持 。 

到 本 章 结束 时 ， 你 将 清楚 地 了 解 模块 系统 对 版 本 的 有 限 支 持 。 这 将 帮助 你 分 析 应 用 程序 ， 甚 
至 可 以 用 来 主动 报告 可 能 的 问题 。 也 许 更 重要 的 是 , 你 还 将 了 解 这 些 限制 背后 的 原因 ,以 及 是 否 
可 以 期 望 针对 版 本 的 支持 发 生变 化 。 你 还 将 学 习 如 何 运行 同一 个 模块 的 多 个 版 本 一 一 但 是 正如 后 
文 所 述 ， 这 样 的 付出 很 不 值得 。 


13.1 JPMS 中 缺乏 版 本 支持 


Java 8 及 之 前 的 版 本 没有 版 本 的 概念 。 如 1.3.3 节 所 述 ， 这 可 能 导致 意外 的 运行 时 行为 ， 而 
唯一 的 解决 方案 可 能 是 选择 不 同 的 依赖 版 本 。 这 很 不 幸 ， 因 此 模块 系统 在 最 初 构 思 时 ， 目 标 之 一 
就 是 纠正 这 种 情况 。 

然而 ， 上 述 情况 并 没有 真正 改变 。 目 前 在 Java 中 运行 的 模块 系统 仍然 对 版 本 没有 概念 ， 其 
改变 仅 限 于 记录 模块 或 依赖 的 版 本 信息 (参见 13.2 区 。 

这 是 为 什么 呢 ? 模块 系统 不 能 支持 同一 模块 的 多 个 版 本 吗 (参见 13.1.1 方 ) ?如 果 不 支 持 ， 
那么 能 至 少将 一 堆 模 块 和 需求 的 版 本 作为 输入 ,并 为 每 个 模块 选择 一 个 版 本 吗 (参见 13.1.2 茵 ? 
这 两 个 问题 的 答案 都 是 “不 ”， 下 文 将 解释 原因 。 
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13.1.1 不 支持 多 版 本 


解决 版 本 冲突 的 一 个 看 似 简单 的 方案 是 允许 运行 同一 个 JAR 的 两 个 版 本 。 该 方案 简单 直接 ， 
为 什么 模块 系统 不 能 这 样 做 呢 ? 要 回答 这 个 问题 ， 必 须 了 解 Java 如 何 加 载 类 。 


1. 类 加 载 机 制 如 何 防止 出 现 多 个 版 本 
1.3.2 节 曾 讨论 过 覆盖 ，JVM ( 或 者 更 准确 地 说 ， 它 的 类 加 载 器 ) ea 
比如 java.util.List 或 monitor.observer.Serviceobserver。 要 从 类 路 径 加 载 一 个 
应 用 程序 类 加 载 器 将 扫描 所 有 JAR， 直 到 过 到 一 个 要 查找 的 特定 名 称 的 类 ， 然 后 进行 加 载 。 


要 点 关键 的 观察 结果 是 , 无论 类 路 径 上 的 另 一 个 JAR 是 否 包 含 具 有 完全 相同 名 
称 的 类 SN 换 和 句 话 说 ， 类 加 载 器 假设 每 个 类 ( 由 其 完全 限定 名 标识 ) 
只 存在 一 


回 到 希望 运行 同一 个 模块 的 多 个 版 本 的 问题 上 , 这 里 的 障碍 是 显而易见 的 : 般 包 
含 具 有 相同 完全 限定 名 称 的 类 ， 如 果 不 做 任何 更 改 ，JVM 则 只 能 看 到 其 中 的 一 个 。 那 么 应 该 更 
改 成 什么 样 呢 ? 


2. 更 改 类 加 载 机制 以 加 载 多 个 版 本 

使 多 个 类 能 够 具有 相同 名 称 的 第 一 个 可 能 选项 是 重 写 整个 类 加 载 机 制 , 以 方便 单个 类 加 载 器 
处 理 这 种 情况 。 该 工程 任务 量 巨大 ， | JVM 中 最 多 只 能 加 载 一 个 给 定名 
称 的 类 。 除 了 要 做 大 量 的 工作 , 它 还 会 带 来 很 多 风险 : 由 于 这 是 一 种 侵入 性 的 变更 ,因此 几乎 可 
以 肯定 它 是 向 后 不 兼容 的 。 

第 二 个 选项 是 允许 多 个 具有 相同 名 称 的 类 来 做 一 些 事情 ， 比 如 OSGi 所 做 的 : 为 每 个 模块 使 
用 单独 的 类 加 载 器 ( 如 图 13-1 所 示 )。 这 相对 比较 简单 ， 但 可 能 会 导致 兼容 性 问题 。 


a 
时 


国 国 钨 | 国画 身 


a 所 有 模块 使 用 同一 个 每 个 模块 一 个 类 


类 加 载 器 加 载 器 
图 13-1 JPMS 对 所 有 应 用 程序 模块 使 用 相同 的 类 加 载 器 ( 左 ), 但 是 可 以 想象 ， 它 也 
可 以 为 每 个 模块 使 用 单独 的 类 加 载 器 ( 右 )。 在 许多 情况 下 ， 这 将 改变 应 用 程 
序 的 行为 
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一 个 潜在 的 问题 是 , 一 些 工具 、 框 架 其 至 应 用 程序 对 类 加 载 右 的 层次 结构 做 了 特定 假设 ( 默 
认 情 况 下 ， 有 3 个 相互 引用 的 类 加 载 器 ， 这 在 Java 9 中 没有 改变 。12.4.1 节 提 到 启动 层 时 ， 对 具 
体 细 节 进 行 过 说 明 )。 将 每 个 模块 放 在 它 自 己 的 类 加 载 器 中 会 极 大 地 改变 层次 结构 ， 并 可 能 破坏 
大 多 数 项 目 。 

在 改变 层次 结构 的 过 程 中 还 隐藏 着 男 一 个 不 易 发 现 的 细节 。 即使 你 愿意 让 项 目 适应 从 模块 路 
径 运 行 ， 当 它们 从 类 路 径 运 行 时 ， 又 会 发 生 什 么 呢 ? 来 自 类 路 径 的 JAR 有 单独 的 类 加 载 器 吗 ? 
口 如 果 是 这 样 ， 那 么 那些 在 更 改 后 的 类 加 载 器 层次 结构 中 遇 到 问题 的 项 目 ， 不 仅 不 能 作为 
模块 运行 ， 而 且 不 能 在 Java 9 及 以 上 版 本 中 运行 。 
口 如 果 不 是 这 样 ， 那 么 它们 需要 知道 两 个 不 同 的 类 加 载 层 次 结构 ， 并 根据 所 在 的 路 径 正 确 

地 与 每 个 层次 结构 交互 。 
如 果 将 其 应 用 于 整个 生态 系统 ， 那 么 这 些 对 兼容 性 或 迁移 路 径 的 影响 都 是 不 可 接受 的 。 

































































注意 ”这些 关 注 点 的 权重 与 OSGi 不 同 ， 它 提供 的 功能 对 大 多 数 使 用 它 的 应 用 程序 而 言 
是 必 不 可 少 的 ， 因 此 可 以 期 望 相 应 的 开发 人 员 对 其 投入 更 多 的 精力 。 然 而 ，Java9 及 以 
上 版 本 也 需要 考虑 不 关心 模块 系统 的 项 目 。 因 为 OSGi 是 可 选 的 ， 所 以 到 了 紧要 关头 ， 
如 果 它 对 任何 特定 项 目 都 不 起 作用 ,就 可 以 忽略 它 , 但 显然 Java9 及 以 上 版 本 不 是 这 种 
情况 。 

要 点 每 个 JAR 所 拥有 的 特定 类 加 载 器 可 能 出 问题 的 另 一 个 原因 与 类 相等 有 关 。 
Bh 入“) 让 我 们 假设 同一 个 类 由 两 个 不 同 的 类 加 载 器 加 载 。 它 们 的 Class<?> 实 例 不 相等 ， 

因为 类 加 载 器 总 是 包含 在 该 检查 中 ， 但 是 谁 在 乎 呢 ? 


La 





如 果 对 于 每 个 类 ， 你 都 有 一 个 实例 , 并 对 它们 进行 比较 , 那么 在 equals 比较 中 首先 会 发 生 
什么 呢 ? 会 发 牛 this.getclass() == other .getclass() 或 instanceof 检查 。 在 本 例 中 ， 
这 将 始终 为 false， 因 为 这 两 个 类 不 相等 。 

这 意味 着 对 于 有 两 个 版 本 的 Guava 来 说 ， multimapl.equals (multimap2) 总 是 错误 的 
不 管 这 两 个 Multimap 实例 包含 什么 元 素 。 你 也 不 能 将 从 一 个 加 载 器 加 载 的 类 转换 成 从 另 一 个 加 
载 器 加 载 的 同一 个 类 ， 所 以 (Multimap) multimap2 可 能 会 失败 。 


调用 实例 Multimap 的 equals 
方法 , 该 方法 在 其 类 加 载 器 的 上 








static boolean equalsImpl( 


Multimap<?, ?> multimap, 二 下 文中 执行 
GNullableDpec]l1 Object object) { 
人 传递 给 eauals 方法 的 object 对 象 ， 
if (object == multimap) { 它 被 认为 是 来 自 不 同类 加 载 器 的 
与 AN | 人 
return true; 已 优 b 和 J 斩 页 
} Multimap 实例 
if (object instanceof Multimap) { < - 
Multimap<?, ?> that = (Multimap<?, ?>) object; 
return multimap.asMap() .equals (that .asMap ()); 
} SE 
object 是 来 自 另 一 个 类 加 载 器 的 Multimap 类 


return false; 这 
型 ， 因 此 这 个 instanceof 检查 总 是 失败 
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如 果 能 知道 有 多 少 项 目 会 因为 这 个 细节 而 出 错 就 好 了 , 可 是 没 办 法 知道 ,但 我 狂 有 很 多 。 与 
之 相 比 ， 第 6 章 和 第 7 章 的 方案 完全 是 良性 的 。 


注意 ”顺便 说 一 下 ， 刚 才 讨 论 的 所 有 内 容 也 适用 于 包 分 裂 (参见 7.2 节 )。 如 果 模 块 系 
统 不 关心 两 个 模块 是 否 包 含 相同 的 包 ， 并 且 可 以 将 它们 分 开 ，, 这 不 是 很 好 吗 ? 是 的 ,但 
这 样 会 遇 到 前 文 刚刚 讨论 过 的 问题 。 


到 目前 为 止 , 我 们 所 确定 的 只 是 模块 系统 不 允许 同一 模块 出 现 多 个 版 本 。 但是, 没有 原生 支 
持 ， 并 不 意味 着 绝对 不 可 能 ，13.3 节 将 介绍 如 何 解 决 该 问题 。 


13.1.2 不 支持 版 本 选择 


如 果 模 块 系统 不 能 加 载 同一 个 模块 的 多 个 版 本 ， 为 什么 它 不 能 至 少 为 人 们 选择 正确 的 版 本 
呢 ? 当然 ， 理 论 上 是 可 能 的 ， 但 很 遗憾 这 不 具有 可 行 性 ， 下 面 解释 一 下 原因 。 


1. 构建 工具 如 何 处 理 版 本 

像 Maven 和 Gradle 这 样 的 构建 工具 总 是 使 用 版 本 化 的 JAR， 它 们 知道 每 个 JAR 的 版 本 及 其 
依赖 的 版 本 。 考虑 到 它们 是 许多 项 目 所 依赖 的 基础 框架 , 所 以 很 自然 地 , 它们 拥有 很 深 的 依赖 树 ， 
这 些 树 可 能 多 次 纳入 相同 的 JAR， 而 这 些 JAR 可 能 有 不 同 的 版 本 。 

虽然 知道 受 依赖 的 JAR 有 多 少 个 不 同 的 版 本 这 一 点 很 好 ， 但 并 不 能 改变 这 样 一 个 事实 : 它 
们 最 好 不 要 都 在 类 路 径 上 。 如 果 都 在 ， 你 将 遇 到 覆盖 (参见 1.3.2 节 ) 和 直接 的 版 本 冲突 (参见 
1.3.3 节 ) 这 样 的 问题 ， 这 将 威胁 项 目的 稳定 性 。 


要 点 “ 当 需 要 编译 、 测 试 或 启动 一 个 项 目 时 ， 构 建 工 具 必须 将 树 展 平 ， 使 其 成 为 
只 包含 每 个 JAR 一 次 的 列表 ( 如 图 13-2 所 示 )。 实 际 上 ， 必 须 为 每 个 工件 选择 一 
个 版 本 。 这 是 一 个 重要 的 过 程 ， 如 果 工 件 可 以 为 每 个 依赖 定义 一 系列 可 接受 的 版 
本 ， 该 过 程 尤 其 重要 。 因 为 这 个 过 程 并 非 无 足 轻重 ， 也 不 是 特别 透明 。 人 们 很 难 
预测 Maven 或 Gradle 会 选择 哪个 版 本 , 所 以 在 相同 的 情况 下 , 不 一 定 选择 相同 的 
版 本 也 就 不 足 为 奇 了 。 
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应 用 程序 JAR 及 其 
依赖 人 
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类 库 johnson 和 mango 类 路 径 上 应 该 只 有 
可 能 以 不 同 的 版 本 出 一 个 版 本 的 johnson 
现 了 两 次 和 mango 








图 13-2 ”应 用 程序 的 依赖 树 〈 左 ) 可 能 不 止 一 次 地 包含 相同 的 JAR， 就 像 jonnson 和 
mango 一 样 ， 可 能 有 不 同 的 版 本 。 要 在 类 路 径 上 工作 ， 必 须 将 这 个 树 展 平 为 
只 包含 每 个 JAR 一 次 的 集合 ( 右 ) 


2. 为 什么 模块 系统 不 选择 版 本 

现在 抛 开 构 建 工 具 来 谈 谈 模块 系统 。 就 像 13.2 节 将 要 展示 的 ， 模 块 可 以 记录 自己 的 版 本 以 
及 各 依赖 的 版 本 。 假设 模块 系统 无 法 运行 同一 个 模块 的 多 个 实例 , 难道 它 不 能 为 每 个 实例 选择 一 
个 独立 的 版 本 吗 ? 

下 面 推演 一 下 。 在 这 个 假定 的 场景 中 , JPMS 需要 在 模块 路 径 中 接受 同一 个 模块 的 不 同 版 本 。 
而 在 构建 模块 图 时 ， 它 需要 为 每 个 模块 决定 选择 哪 一 个 版 本 。 


要 点 ”这 意味 着 JPMS 需要 重复 构建 工具 已 经 做 过 的 事情 。 由 于 它们 采用 的 方式 
不 同 ， 因 此 模块 系统 的 行为 将 略 有 差异 。 更 糟糕 的 是 ， 由 于 Java 基 于 一 种 标准 ， 
精确 的 行为 需要 被 标准 化 ， 这 使 其 难以 随 着 时 间 的 推移 而 发 展 。 

除 此 之 外 ， 还 要 考虑 实现 和 维护 版 本 选择 算法 的 成 本 。“ 压 垮 骆 驼 的 最 后 一 根 稻 
草 ” 是 性 能 :如果 编译 器 和 JVM 在 开始 它们 的 实际 工作 之 前 不 得 不 运行 这 个 算 
法 , 则 会 极 大 地 增加 编译 和 启动 时 间 。 如 上 文 所 述 , 版 本 选择 并 不 廉价 , 所 以 Java 
不 采用 它 是 合理 的 。 
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13.1.3 ”未 来 会 怎样 


简 而 言 之 , 模块 系统 与 版 本 无 关 ， 这 意味 着 版 本 信息 不 会 影响 其 行为 。 这 是 当前 的 状况 。 但 
很 多 开发 者 希望 将 来 Java 能 够 支持 这 些 特性 。 我 无 意 泼冷水 ， 如 有 果 你 也 是 其 中 一 员 ， 尽 管 当前 
的 状况 不 意味 着 将 来 模块 系统 不 会 支持 版 本 ， 但 我 对 此 持 保留 意见 。 


要 点 ”作为 Oracle Java 平台 小 组 首席 架构 师 以 及 模块 系统 规范 的 领导 者 ，Mark 
Reinhold 曾经 反复 公开 上 声明， 他 不 认为 Java 在 未 来 会 支持 模块 版 本 。 考 虑 到 这 样 
的 特性 所 需要 的 巨大 投入 ， 以 及 回报 的 不 确定 性 ， 我 可 以 理解 他 是 如 何 做 出 这 个 
决定 的 。 

这 意味 着 我 们 仍然 不 得 不 为 版 本 问题 头 疫 ， 但 这 种 头 疫 并 非 徒劳 无 益 ( 这 听 起 来 
有 些 像 斯 德 哥 尔 摩 综 合 征 " 发 作 ), 在 整个 项 目 中 统一 版 本 范围 , 并 且 确 保 应 用 程 
序 由 一 系列 唯一 的 JAR 来 提供 支持 ， 这 样 的 努力 ( 有 时 候 确实 很 难 ) 实际 上 会 提 
供 很 多 好 处 。 


想 一 下 , 其 实 你 并 不 想 这 么 做 。 你 的 项 目 需要 把 多 少 额外 的 JAR 放 到 类 路 径 或 模块 路 径 中 ? 
它 会 因此 变 得 多 大 ? 调试 会 变 得 多 复杂 ? 算 了 吧 , 允许 同 时 使 用 多 个 有 冲突 的 版 本 将 是 一 个 非常 
糕 的 主 

尽管 如 此 ， 因 版 本 冲突 导致 重要 工作 突然 信 死 ,或 者 为 了 革 个 关键 升级 不 得 不 在 同时 刻 更 新 
大 量 其 他 依赖 这 些 问题 依然 存在 。 为 此 , 最 好 提供 一 个 命令 行 选项 , 比如 java - -one class- 
loaaer-per-moaule， 供 你 在 事情 不 顺 时 进行 尝试 。 可 惜 的 是 ， 这 个 命令 ( 目前) 并 不 存在 。 


13.2 ”记录 版 本 信息 


cia 模块 系统 不 处 理 版 本 信息 。 但 很 有 趣 的 是 ,， 它 确实 允许 人 们 记录 和 访 
问 版 本 信息 。 乍 听 起 来 似乎 有 些 不 可 思议 ， 但 版 本 信息 在 调试 应 用 程序 时 会 有 帮助 。 

在 讨论 从 哪里 可 以 看 到 版 本 信息 以 及 它 提 供 了 哪些 好 处 (参见 13.2.2 节 ) 之 前 , 首先 了 解 一 
下 如 何在 编译 和 打包 过 程 中 记录 版 本 信息 (参见 13.2.1 节 )。 记 录 和 评估 版 本 信息 的 例子 存放 在 


ServiceMonitor 的 feature-versions 分 支 中 。 


13.2.1 在 构建 模块 时 记录 版 本 











如 
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定义 : --module-version 
javac 和 jar 命令 接收 命令 行 选 项 --module-version $s{version}。 它 将 给 定 版 本 ( 可 
以 是 任意 字符 串 ) 误 入 到 模块 描述 符 中 。 






































@ 斯德哥尔摩 综合 征 ， 指 被 害 者 对 于 犯罪 者 产生 情感 ， 甚 至 协助 犯罪 者 的 一 种 情结 。 译 者 注 
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不 论 这 个 选项 是 否 得 到 使 用 , 只 要 模块 编译 所 用 的 茶 个 依赖 记录 了 版 本 , 编译 器 就 会 把 这 
个 信息 加 入 到 模块 描述 符 中 。 这 意味 着 模块 描述 符 不 仅 包含 模块 自己 的 版 本 信息 , 也 包含 模块 
编译 时 所 使 用 的 所 有 依赖 的 版 本 信息 。 


如 果 模 块 原本 就 带 有 版 本 信息 , 那么 jar 命令 可 以 将 它 履 盖 。 因 此 ， 如果 jar 和 javac 都 
使 用 了 --module-version， 那么 只 有 传 给 jar 的 值 会 生效 。 
前 文中 ， 代 码 清单 2-5 显示 过 如 何 编译 和 打包 monitor 模块 ， 但 不 必 翻 回去 看 。 修 改 对 应 的 
jar 命令 以 记录 版 本 非常 简单 。 
$ jar --create 
--file mods/monitor.jar 
--module-version 1.0 


--main-class monitor.Monitor 
-C monitor/target/classes . 






































如 以 上 代码 所 示 ， 这 简单 到 只 需 一 个 --module-version 1.0 选项 。 因 为 脚本 会 对 模块 进 
行 编 译 并 马上 将 其 打包 ， 所 以 没有 必要 在 javac 中 也 增加 这 个 选项 。 
要 检查 编译 打包 是 否 成 功 ， 仅 需要 执行 jar --describe-module (参见 4.5.2 欧 。 


S jar --describe-module --file mods/monitor.jar 




















> monitor@1.0 jar:.../monitor.jar/!'module-info.class 
> requires java.base mandated 

> requires monitor.observer 

# 省 略 了 requires 的 输出 

> contains monitor 

> main-class monitor.Main 


版 本 就 在 第 一 行 : monitor@1 .0。 为 什么 依赖 模块 的 版 本 没有 显示 ? 因为 本 例 没有 记录 它 
们 。 但 是 java.base 绝对 拥有 版 本 ， 它 也 没有 显示 。 实 际 上 ，--describe-module 选项 不 会 打印 
这 个 信息 ， 不 论 jar 还 是 java 命令 都 是 这 样 。 

要 访问 依赖 模块 的 版 本 , 需要 采取 不 同 的 方式 。 下 面 看 一 下 版 本 信息 在 哪里 显示 ,以 及 如 何 
访问 它 。 


13.2.2 ”访问 模块 版 本 


译 和 打包 过 程 中 所 记录 的 版 本 信息 会 在 不 同 地 方 显 示 。 如 上 文 所 述 ，jar --describe- 
module 和 java --describe-module 都 会 打印 模块 版 本 。 


1. 栈 跟踪 中 的 版 本 信息 
栈 跟 踪 也 是 重要 的 位 置 。 如 果 代 码 在 模块 中 运行 , 那么 模块 的 名 字 会 与 包 名 、 类 名 以 及 方法 
名 一 起 被 打印 到 每 条 栈 帧 中 。 好 消息 是 ， 模 块 版 本 也 在 其 中 。 
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> Exception in thread "main" java.lang.IllegalArgumentException 
> at monitor@1.0/monitor.Main.outputVersions (Main.java:46) 
S at monitor@1.0/monitor.Main.main (Main.java:24) 


这 不 是 一 种 革命 性 的 进化 , 但 绝对 是 一 条 很 好 的 附加 信息 。 如 果 代 码 由 于 不 明 的 原因 而 行 》 
不 当 , 那么 版 本 问题 可 能 是 潜在 的 原因 。 如 果 可 以 在 这 样 显眼 的 地 方 看 到 版 本 信息 ， 则 会 让 人 们 
更 容易 注意 到 它 ， 从 而 发 现 可 疑 之 处 。 


要 点 “我 已 经 认同 版 本 信息 可 以 带 来 巨大 的 帮助 。 强 烈 建议 你 更 新 构建 工具 的 配 
置 以 记录 版 本 。 














2. 反射 API 中 的 模块 版 本 信息 
可 以 认为 ， 处 理 版 本 信息 最 有 趣 的 地 方 是 反射 API。( 要 继续 阅读 ， 需 要 了 解 java. lang . 
ModuleDescriptor。 如 果 尚 不 了 解 它 ， 请 查阅 12.3.3 节 ) 








要 点 ”如 代码 清单 12-7 和 代码 清单 13-1 所 示 ，ModuleDescriptor 类 包含 一 个 
rawVersion() 方 法 。 它 返回 了 一 个 Optional<String> 对 象 , 该 对 象 极 可 能 
含 版 本 字符 串 (与 传 给 --module-version 的 一 模 一 样 )， 也 可 能 是 空 的 ( 如果 
没有 使 用 这 个 选项 的 话 )。 

除 此 之 外 ， 还 有 version () 方 法 ， 该 方法 返回 一 个 Optional<Version> 对 象 ， 
其 中 Version 是 一 个 ModuleDescriptor 的 内 部 类 ， 将 原始 版 本 信息 解析 成 
了 一 个 可 对 比 的 描述 。 如 果 没 有 原始 版 本 信息 ,或 者 解析 失败 ，Optional 则 是 


空 的 。 





代码 清单 13-1 访问 模块 的 原始 版 本 和 解析 版 本 


ModuleDescriptor descriptor = getClass() 


.getModule() 
.getDescriptor(); ， 
String raw = descriptor 如 果 --module-version 未 被 使 用 , 则 返 
.rawVersion () 回 一 个 空 的 optional<String> 对 象 
.orElse("unknown version"); 如 果 rawversion() 是 空 的， 或 者 原始 版 
String parsed = descriptor 本 信息 无 法 被 解析 ， 则 返回 一 个 空 的 
.Version() 二 - - Optional<Version> 对 象 


.map (Version: :toString) 
.orElse ("unknown or unparsable version"); 


3. 反射 API 中 依赖 模块 的 版 本 信息 

前 文 已 经 介绍 了 如 何 获取 模块 自己 的 版 本 , 但 仍然 不 知道 如 何 获取 依赖 模块 的 版 本 。 代 码 清 
单 12-8 展示 过 打印 MoGuleDescriptor 输出 的 所 有 内 容 ， 其 中 包含 下 面 这 个 片段 。 

[] module monitor.persistence @ [] { 


requires [ 
hibernate.jpa, 
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mandated java.base (@9.0.4), 
monitor.statistics] 
Ls td 
} 
看 到 其 中 的 e9.0.4 了 吗 ? 那 是 Requires::toString 输出 的 部 分 内 容 。Requires 是 
ModuleDescriptor 的 男 一 个 内 部 类 ， 在 模块 描述 符 中 呈现 了 一 个 requires 指令 。 


要 点 针对 一 个 给 定 的 模块 ， 可 以 通过 调用 module.getDescriptor() . 
requires () 得 到 一 个 Set<Requires> 对 人 象 。Requires 实例 包含 了 一 些 信息 ， 
最 典型 的 是 所 需 模块 的 名 字 (name () 方 法 )， 以 及 编译 所 用 的 原始 版 本 和 解析 版 
本 (相应 的 rawCompiledVersion() 和 compiledVersion() 方 法 ), 代码 清单 
13-2 展示 了 获得 模块 描述 符 ,然后 对 所 记录 的 requires 指令 进行 流 处 理 的 代码 。 





代码 清单 13-2 打印 依赖 的 版 本 信息 


module 
.getDescriptor() 
.requires() .stream!() 


.map (requires -> String.format("\t-> %s @ %s", 
requires.name(), 
requires.rawCompiledVersion() .orElse("unknown"))) 
.forEach(System.out: :println); 


这 段 代 码 产生 的 输出 如 下 。 


> monitor @ 1.0 

-> monitor.persistence @ 1.0 

-> monitor.statistics @ 1.0 
-> java.base @ 9.0.4 

和 省 略 了 更 多 依赖 的 输出 


这 些 就 是 编译 monitor 模块 依赖 所 需 的 版 本 信息 

写 一 个 类 , 利用 这 个 信息 比较 编 i er 如 
果实 际 版 本 更 低 , 那么 它 可 以 为 这 种 潜在 的 问题 提供 警告 ， 或 者 将 所 有 信息 打印 到 日 志 中 , 方便 
在 出 问题 时 分 析 原 因 。 


13.3 ”在 不 同 的 层 中 运行 同一 个 模块 的 多 个 版 本 


13.1.1 节 曾 提 到 , 模块 系统 对 运行 同一 个 模块 的 多 个 版 本 没有 原生 支持 。 但 前 文 已 经 暗示 过 ， 
这 并 不 意味 着 不 可 能 同时 存在 多 个 版 本 。 在 JPMS 登场 之 前 ， 人 们 的 处 理 方法 如 下 。 

口 构建 工具 将 依赖 隐藏 到 一 个 JAR 中 ， 这 意味 着 该 依赖 中 的 所 有 类 文件 都 被 复制 到 了 目标 
JAR 中 ,但 用 的 是 一 个 新 的 包 名 。 对 这 些 类 的 引用 也 被 替换 为 了 新 的 类 名 。 这 样 ， 带 有 
com.google.collect 包 的 独立 Guava JAR 就 不 再 被 需要 了 , 因为 它 的 代码 已 经 被 移动 
到 了 org.library.com.google.collection 中 。 如 果 每 个 项 目 都 这 么 做 ， 那 么 不 同 
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版 本 的 Guava 就 不 再 会 冲突 了 。 
口 一 些 项 目 使 用 OSGi 或 者 其 他 原生 支持 多 个 版 本 的 模块 系统 。 
口 另外 一 些 项 目 创建 自己 的 类 加 载 器 层级 ,以 避免 不 同 实例 间 的 冲突 (OSGi 也 是 这 么 令 g )。 
上 述 每 个 方法 都 有 自身 的 不 便 之 处 , 但 这 里 不 会 对 它们 进行 详细 研究 。 如 果 你 确实 不 得 不 运 
行 同 一 个 JAR 的 不 同 版 本 ， 就 需要 找到 一 个 对 你 的 项 目 而 言 值得 这 样 做 的 方案 


& 











ON 要 点 ”这 就 是 说 , 模块 系统 会 将 已 有 方案 重新 打包 , 这 是 本 节 关 注 的 重点 。 然而， 
a 虽然 这 样 做 人 们 能 够 同时 运行 多 个 版 本 ， 但 是 仍 将 发 现 其 有 些 复杂 ， 所 以 也 许 就 
不 想 做 了 。 这 更 像 是 一 个 论证 ， 而 不 是 有 实际 意义 的 方案 。 


13.3.1 为 什么 需要 一 个 添加 额外 层 的 启动 器 


如 12.4 节 所 述 ， 模块 系统 引入 了 层 这 个 概念 ， 从 根本 上 将 模块 图 与 类 加 载 器 关联 在 了 一 起 。 
永远 都 至 少 会 存在 一 个 层 ， 即 模块 系统 在 启动 时 根据 模块 路 径 内 容 创建 的 启动 层 。 

除 此 之 外 ,， 层 可 以 在 运行 时 创建 ， 并 需要 一 系列 模块 作为 输入 : 例如 ， 从 文件 系统 中 的 某 个 
目录 开始 , 然后 根据 可 靠 性 规则 对 其 进行 评估 ， 以 确保 生成 一 个 可 靠 配 置 。 如 果 一 个 层 包含 同一 
个 模块 的 多 个 版 本 ， 则 它 无 法 被 创建 。 这 样 的 话 ， 唯 一 可 以 实现 同一 个 模块 的 多 个 版 本 的 方式 ， 
是 将 它们 安排 在 不 同 的 层 中 。 


本 人 要 点 ”这 意味 着 不 必 启 动 应 用 程序 ， 只 需 在 一 个 启动 器 中 输入 以 下 内 容 并 局 动 。 

> 口 所 有 应 用 程序 模块 的 路 径 。 

口 模块 之 间 的 关系 ， 同 时 要 考虑 它们 的 不 同 版 本 。 
然后 需要 创建 放置 层 的 图 ， 这些 图 的 排列 使 得 每 个 层 仅 包含 每 个 模块 一 次 ， 而 不 
同 的 层 可 以 包含 同一 模块 的 不 同 版 本 。 最 后 一 步 是 填 满 实际 的 层 , 然后 调用 main 
函数 。 

开发 这 样 一 个 作为 通用 解决 方案 的 启动 器 是 一 项 艰巨 的 工程 , 并 且 这 实际 上 意味 着 要 重新 实 
现 现 有 的 第 三 方 模块 系统 。 创 建 仅 解决 特定 问题 的 启动 器 则 容易 得 多 , 因此 本 节 将 重点 关注 这 一 
方面 。 在 本 节 的 最 后 ， 你 将 了 解 如 何 创 建 一 个 简单 的 层 结构 ， 使 你 能 运行 同一 模块 的 两 个 版 本 。 





























就 









































13.3.2 ”为 你 的 应 用 程序 、Apache Twill 和 Cassandra Java Driver 启动 层 


假设 你 依赖 两 个 项 目 : Apache Twill 和 Cassandra Java Driver。 它 们 对 Guava 的 版 本 要 求 有 冲 

突 : Apache Twill 无 法 使 用 Guava 13 之 后 的 任何 版 本 , 而 Cassandra Java Driver 无 法 使 用 Guava 16 

之 前 的 任何 版 本 。 你 已 经 尝试 了 所 有 可 以 解决 此 问题 的 方法 , 但 是 没有 任何 效果 , 现在 想 通过 层 
来 解决 这 个 问题 。 

这 意味 着 基础 层 仅 包含 应 用 程序 启动 器 。 启动 器 需要 使 用 Guava 13 创建 一 个 层 , 使 用 Guava 
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16 创建 另 一 个 层 ， 而 它们 都 需要 引用 基础 层 才 能 访问 平台 模块 。 接 着 是 第 四 层 ， 其 中 包含 应 用 
程序 的 其 余部 分 和 依赖 , 且 由 于 它 引 用 了 启动 如 创建 的 其 他 两 层 , 因此 可 以 在 其 中 查找 依赖 关系 。 

不 过 , 它 并 非 完 全 这 样 工 作 。 当 完成 Apache Twill 的 依赖 解析 后 ,模块 系统 将 两 次 查看 Guava: 
顶层 引用 的 每 个 层 中 各 一 次 , 但 是 一 个 模块 不 能 多 次 读 取 另 一 个 模块 ,因为 这 样 将 不 清楚 应 该 从 
哪个 版 本 中 加 载 类 。 

因此 , 将 这 两 个 模块 及 所 有 依赖 放 到 各 自 的 Guava 层 中 ,这 就 很 好 地 完成 了 工作 。 这 两 个 模 
块 都 公开 了 各 自 对 Guava 的 依赖 ， 因 此 你 的 代码 也 需要 查看 Guava。 如 果 该 代码 位 于 顶层 , 那么 
你 最 终 会 遇 到 与 以 前 相同 的 情况 : 模块 系统 将 警告 代码 遇 到 了 两 个 版 本 的 Guava。 

如 果 将 Twill 和 Cassandra 特定 的 代码 也 拉 到 相应 的 层 中 ， 则 会 得 到 如 图 13-3 所 示 的 层 图 。 
现在 ， 创 建 这 些 层 。 为 此 ， 假 定 你 已 将 应 用 程序 模块 组 织 到 3 个 目录 中 。 
口 mods/twill， 包 含 Apache Twill 及 其 所 有 依赖 ， 以 及 与 其 直接 交互 的 模块 ( 在 本 示例 中 为 
app.twill )。 
口 mods/cassandra， 包 含 Cassandra Java Driver 及 其 所 有 依赖 ， 以 及 与 其 直接 交互 的 模块 (在 
本 示例 中 为 app.cassandra )。 
口 mods/app， 包 含 应 用 程序 的 其 余部 分 及 其 依赖 (在 本 示例 中 ， 主 模块 为 app )。 


应 用 程序 及 其 一 些 依赖 
a 在 最 顶层 
更 多 的 依赖 


Cassandra 和 Guava 16 的 层 










































Twill 和 Guava 13 
的 层 









app.cassandra 


v 


cassandra.driver.core 
guava (v16.0) 


© 





app.twill 
guava (v13.0) 


© 
\ 基础 层 
更 多 的 依赖 


图 13-3 Apache Twill 和 Cassandra Java Driver 对 Guava 的 依赖 相 冲 突 。 为 了 让 使 用 这 
两 个 类 库 的 应 用 程序 正常 启动 ， 每 个 类 库 ( 包括 其 各 自 的 依赖 ) 必须 进入 它 
自己 的 层 。 在 它们 之 上 是 包含 应 用 程序 其 余部 分 的 层 ， 之 下 是 基础 层 
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然后 启动 器 就 可 以 执行 了 ， 如 代码 清单 13-3 所 示 。 

(1) 使 用 mods/cassandra 中 的 模块 创建 一 个 层 。 请 仔细 选择 正确 的 模块 作为 解析 过 程 的 根 结 
点 ， 同 时 选择 引导 层 作为 父 层 。 

(2) 对 mods/twill 中 的 模块 执行 相同 的 操作 。 

(3) 使 用 mods/app 中 的 模块 创建 一 个 屋 ， 然 后 选择 主 模 块 作为 根 。 使 用 另外 两 层 作为 父 层 : 
这 样 ， 你 的 应 用 程序 对 mods/cassandra 和 mods/twill 中 模块 的 依赖 就 可 以 得 到 正确 解析 。 

(4) 完成 所 有 操作 后 ， 获 取 上 层 主 模块 的 类 加 载 器 ， 并 调用 其 main 函数 。 


代码 清单 13-3 ”为 Cassandra 、Apache Twill 和 应 用 程序 创建 层 的 启动 带 


public static void main(String[] args) 
throws ReflectiveOperationException { 
createApplicationLayers () 
.findLoader ("app") 
.loadClass ("app.Main") 
.getMethod ("main", String[] .class) 














.invoke(null, (Object) new String[0]); 应 用 程序 层 创建 后 ， 加 载 其 
= FF 
主 类 并 调用 main 函数 
private static ModuleLayer createApplicationLayers() { 


Path mods = Paths.get ("mods"); 


ModuleLayer cassandra = createLayer!( 
List.of (ModuleLayer.boot () ) ， 
mods .YeSsolve("caSsSsandqra" ) ， 
"app.cassandra"); 本 一 — 
ModuleLayer twill = createLayer!( 
List.of (ModuleLayer.boot () ) ， 
mods.resolve ("twill"), 
"ppp. twill"); 一 


为 Twill 和 Cassandra 各 创 
建 一 个 层 ， 其 中 各 自 包 含 整 

| 个 项 目 以 及 你 的 模块 与 其 交 
互 的 部 分 


主 应 用 程序 层 首先 在 你 的 主 
模块 中 开始 解析 ， 并 且 把 
twill 层 和 cassandra 层 作为 
父 层 


return createLayer ( 
List.of(cassandqra，twil1)， 
mods.resolve ("app"), 
"app"); 有 一 一 
} 


private static ModuleLayer createLayer!( 本 ~ 
List<ModuleLayer> parentLayers, 
Path modulePath, 
String rootModule) { 
Configuration configuration = createConfiguration( 





parentLayers, 
modulePath, createLayer 和 createConfiguration 方 
rootModule); 法 与 12.4.3 节 中 的 部 分 类 似 ， 主 要 区 别 是 它 
return ModuleLayer 们 指定 了 用 于 解析 的 根 模块 《之 前 没 必要 ， 
.defineModulesWithOneLoader ( 因为 你 依赖 于 服务 绑 定 一 一 但 是 此 处 不 同 ) 
configuration, 
parentLayers, 
ClassLoader.getSystemClassLoader()) 





.layer(); 
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} 


private static Configuration createConfiguration( #D 

List<ModuleLayer> parentLayers, 
Path modulePath, 
String rootModule) { 

List<Configuration> configurations = parentLayers.stream!() 
.map (ModuleLayer: :configuration) 
.Collect (toList()); 

return Configuration.resolveAndBind!l( 
ModuleFinder.of(), 
configurations, 
ModuleFinder.of (modulePath), 
List.of (rootModule) 


} 


就 是 像 上 面 这 样 ! 理解 这 些 需 要 一 些 时 间 , 并 且 可 能 也 需要 花 一 些 时 间 才 能 使 其 工作 ( 对 于 
我 而 言 是 这 样 )。 但 是 如 果 这 是 唯一 的 解决 方案 ,那么 它 还 是 值得 尝试 的 。 









































13.4 ”小 结 


口 javac 和 jar 命令 使 人 们 可 以 使 用 --module-version sfversion} 选 项 指定 模块 版 
本 。 它 将 指定 版 本 舱 入 模块 声明 中 ， 人 们 可 以 使 用 命令 行 工 具 ( 比如 jar --describe- 
module ) 和 反射 API (ModuleDescriptor: :rawVersion ) 读 取 版 本 信息 。 另 外 栈 跟 
踪 信 息 也 会 显示 模块 版 本 。 

口 如 果 一 个 模块 知道 自己 的 版 本 ， 而 另 一 个 模块 基于 该 模块 进行 了 编译 ， 那 么 编译 需 会 将 
版 本 信息 记录 到 后 者 的 描述 符 中 。 此 信息 仅 在 由 ModuleDescriptor::requires 返回 
的 Requires 实例 上 可 用 。 

口 模块 系统 不 以 任何 方式 处 理 模块 版 本 信息 ， 如 果 模 块 路 径 中 包含 多 个 模块 版 本 ， 模 块 系 
统 不 会 尝试 为 其 选择 特定 的 版 本 ， 而 会 退出 并 显示 错误 信息 。 这 样 可 以 将 代价 高 昂 的 版 
本 选择 算法 排除 在 JVM 和 Java 标准 之 外 。 

口 模块 系统 没有 对 运行 同一 模块 的 多 个 版 本 提供 开 箱 即 用 的 支持 。 根 本 原因 在 于 类 加 载 机 

制 。 该 机 制 假定 每 个 类 加 载 器 对 于 任何 给 定名 称 最 多 只 知道 一 个 类 。 如 果 需 要 运行 多 个 
版 本 ， 就 需要 多 个 类 加 载 器 。 

口 OSGi 通 过 为 每 个 JAR 创建 一 个 单独 的 类 加 载 器 来 完成 这 项 工作 。 虽然 创建 类 似 的 通用 解 
决 方案 是 一 项 艰巨 的 任务 ， 但 是 针对 具体 问题 定制 一 个 更 简单 的 方案 是 可 行 的 。 要 运行 
同一 模块 的 多 个 版 本 ， 可 以 通过 创建 层 和 关联 的 类 加 载 器 将 冲突 的 模块 分 开 。 







































































通过 jlink 定制 运行 时 镜像 








本 章 内 容 

口 基于 选 定 内容 创 建 镜像 

口 生成 本 地 应 用 程序 启动 器 

口 判断 镜像 的 安全 性 、 性 能 和 稳定 性 
口 生成 和 优化 镜像 














讨论 Java 模块 化 的 一 个 主要 动机 一 直 是 当前 所 谓 的 物 联 网 ( Internet ofThing, IoT )。 对 OSGi 
来 说 确实 如 此 ， 它 是 Java 使 用 最 广泛 的 第 三 方 模块 系统 ， 于 1999 年 成 立 ， 则 在 改进 艇 入 式 Java 
应 用 程序 的 开发 。Jigsaw 项 目 也 是 如 此 ， 它 开发 了 JPMS， 并 且 期 望 通过 以 下 方式 使 平台 更 具 扩 
展 性 : 仅 使 用 (和 能 入 式 ) 应 用 程序 所 需 的 代码 即 可 创建 尺寸 很 小 的 运行 时 镜像 。 

这 就 是 jlink 的 由 来 。 它 是 一 个 Java 命令 行 工具 (位 于 JDK 的 bin 目录 中 ), 可 用 于 选择 需 
要 的 平台 模块 , 并 将 它们 链接 到 同一 个 运行 时 镜像 中 。 这 样 的 运行 时 镜像 的 行为 完全 类 似 于 JRE,， 
但 仅 包含 所 选择 的 模块 和 需要 的 依赖 项 (通过 requires 指令 )。 在 链接 阶段 , 可 使 用 jlink 进 
一 步 优 化 镜像 大 小 并 改善 Java 虚拟 机 性 能 ， 尤 其 是 缩短 启动 时 间 。 

不 过 ， 自 Jigsaw 项 目 诞生 以 来 的 几 年 里 ， 已 经 发 生 了 很 多 变化 。 一 方面 ， 能 入 式 设备 中 的 
磁盘 空间 不 再 那么 昂贵 。 另 一 方面 ， 我 们 已 经 看 到 了 虚拟 化 的 兴起 ， 其 中 最 显著 的 是 Docker， 
它 再 次 引起 了 人 们 对 容器 大 小 的 关注 ( 尽管 这 不 是 主要 问题 )。 容 器 化 的 兴起 也 给 简化 和 自动 化 
部 署 带 来 了 压力 ， 因 为 现在 部 署 的 频率 要 高 出 几 个 数量 级 。 

jlink 在 这 里 也 能 提供 帮助 。 它 不 仅 可 以 链接 平台 模块 , 还 可 以 创建 应 用 程序 镜像 : 其 中 包 
括 应 用 程序 代码 ， 以 及 类 库 和 框架 模块 。 这 使 得 构建 过 程 可 以 生成 一 个 完全 独立 的 可 部 署 单元 ， 
该 单元 由 整个 应 用 程序 以 及 所 需 的 平台 模块 组 成 , 根据 需要 可 对 镜像 大 小 和 性 能 进行 优化 , 并 且 
可 以 简单 地 通过 调用 本 地 脚本 来 启动 。 

如 果 你 是 一 位 专注 于 桌面 应 用 程序 的 开发 者 ， 当 我 提 到 IoT 和 Docker 时 ， 你 可 能 不 太 关 心 ， 
但 jlink 肯定 能 让 你 兴奋 。 通 过 jlink， 用 户 可 以 非常 容易 地 发 布 一 个 无 须 进 一 步 设置 即 可 启 
动 的 Zip 文件。 而且 ， 如 果 你 一 直 在 使 用 javapackager， 那么 会 很 高 兴 听 到 它 现 在 在 内 部 调用 
jlink， 因 为 这 会 让 你 很 容易 使 用 它 的 所 有 功能 (虽然 我 不 打算 介绍 集成 , 但 javapackager 
文档 中 已 经 介绍 过 了 )。 
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党 





因此 , 开始 使 用 jlink 吧 ! 本 章 先 从 基于 平台 模块 创建 运行 时 镜像 开始 (参见 14.1 前 ， 利 
用 该 机 会 深入 探索 链接 过 程 的 细节 、 人 研究 生成 的 镜像 ， 并 讨论 如 何 选择 正确 的 模块 ; 然后 讨论 如 
何 包含 应 用 程序 模块 和 创建 自 定 义 启动 器 (参见 14.2 节 ); 接 下 来 讨论 如 何 跨 操作 系统 生成 镜像 
(参见 14.3 节 ); 最 后 会 关注 镜像 大 小 和 性 能 优化 (参见 14.4 区 。 

关于 代码 ， 请 查看 ServiceMonitor 代码 库 中 的 feature-jlink 分 支 。 在 本 章 的 最 后 ， 你 将 
了 解 如 何 为 各 种 操作 系统 创建 优化 后 的 运行 时 镜像 ( 其 中 可 能 包含 整个 应 用 程序 )。 通 过 这 种 方 
式 ， 你 就 可 以 构建 一 个 在 服务 器 或 客户 的 计算 机 上 可 直接 部 署 的 单元 了 。 


14.1 创建 自 定义 运行 时 镜像 


jlink 的 一 大 用 例 是 创建 Java 运行 时 镜像 ， 并 且 该 镜像 仅 包含 应 用 程序 所 需 的 模块 。 创 建 
的 结果 就 是 量 身 定 制 的 JRE， 其 中 完美 地 仪 包含 你 的 代码 所 需 的 模块 ， 不 多 不 少 。 然 后， 你 可 以 
像 使 用 其 他 JRE 一 样 ， 通 过 该 镜像 中 的 java 可 执行 文件 启动 应 用 程序 。 

自 定义 运行 时 镜像 具有 一 系列 优点 : 可 以 节省 一 些 磁盘 空间 (镜像 尺寸 较 小 )、 可 以 节省 网 
络 带 宽 (如 果 远 程 部 署 的 话 )、 通 常 更 安全 ( 类 越 少 意味 着 攻击 面 越 小 )， 甚 至 可 以 启动 得 更 快 
(更 多 细节 参见 14.4.3 芍 。 


















































注意 话 虽 如 此 , 但 jlink“ 只 是 ”链接 了 字 节 码 ， 不 会 将 其 编译 为 机 器 码 。 你 可 能 
经 听 说 ， 从 Java 9 开始 ，Java 进行 了 AOT (ahead-of-time ) 编译 实验 ,但 jlink 与 之 
无 关 。 要 了 解 Java 中 的 AOT， 请 查看 Java 增强 建议 295。 


要 点 一 旦 在 Java9 及 以 上 版 本 中 运行 , 便 可 以 创建 针对 你 的 应 用 程序 的 自 定义 
运行 时 镜像 ， 而 无 须 先 对 其 进行 模块 化 。 


为 了 了 解 如 何 使 用 jlink 创建 运行 时 镜像 ， 本 章 将 从 最 简单 的 镜像 (参见 14.1.1 节 ) 开始 ， 


然后 检查 结果 ( 参见 14.1.2 节 )。 接 下 来 ,本章 将 讨论 服务 的 特殊 处 理 方式 (参见 14.1.3 六 ， 并 
且 以 真实 的 用 例 结束 该 部 分 ， 如何 创建 专用 于 运行 指定 应 用 程序 的 镜像 (参见 14.1.4 茵 。 























14.1.1 jliink 入 门 


定义 : jlink 的 必要 信息 
要 创建 镜像 ，jlink 需要 3 条 信息 ， 每 条 信息 都 有 一 个 对 应 的 命令 行 选项 : 
口 哪里 可 以 找到 可 用 的 模块 ( 由 --module-path 指定 ); 
口 使 用 哪些 模块 ( 由 --add-modules 指定 ); 
口 在 哪个 目录 中 创建 镜像 (由 --output 指定 )。 





最 简单 的 运行 时 镜像 仅 包 含 基础 模块 。 代 码 清单 14-1 显示 了 如 何 使 用 jlink 创建 它 。 
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代码 清单 14-1 创建 仅 包 含 基础 模块 的 运行 时 镜像 


模块 的 位 置 ， 本 例 中 为 本 地 已 需要 添加 到 镜像 中 的 模块 ， 本 
安装 JDK 中 的 平台 模块 例 中 仅 有 java.base 
$ jlink 镜像 的 输出 目录 











--module-path ${jdk-9}/jmods 本 
| j 
--add-modules java.base 在 新 创建 的 镜像 中 执行 Fi 
= Ge a De -> --list-modules， 以 验证 其 
所 不 S 若 
$ jdk-base/bin/java --list-modules 中 是 否 只 包含 基础 模块 


> java.base 

你 需要 告诉 j1ink 在 哪里 可 以 找到 平台 模块 ， 这 似乎 有 些 奇怪 。 对 于 javac 和 java 来 说 
这 不 是 必需 的 ,那么 jlink 为 什么 不 知道 在 哪里 找到 它们 ? 答案 是 跨 平 台 链 接 ，14.3 节 将 对 其 
进行 讨论 。 








注意 ”从 Java 10 开始 ， 模 块 路 径 上 不 再 放置 平台 模块 。 如 果 不 包含 任何 路 径 选 项 ， 那 
么 jlink 将 隐 含 地 从 $JAVA_HOME/jmods 中 加 载 。 


要 点 ”无 论 平台 模块 是 被 显 式 还 是 隐 式 引用 ,建议 你 仅 从 与 jlink 可 执行 文件 完 
全 相同 的 JVM 版 本 中 加 载 它们 。 例如 ,如果 jlink 是 9.0.4 版 本 ,那么 请 确保 它 
从 JDK 9.0.4 中 加 载 平台 模块 。 


给 定 这 3 个 命令 行 选 项 , jlink 会 按照 3.4.1 节 中 的 描述 解析 模块 : 模块 路 径 中 的 内 容 被 视 为 
可 观察 模块 的 全 集 , --add-modules 指定 的 模块 被 视 为 解析 过 程 的 根 。 但 是 jlink 有 一 些 特点 。 


要 点 “默认 情况 下 ， 服 务 (参见 第 10 章 ) 未 被 绑 定 。14.1.3 节 将 说 明 原因 ， 并 探 
讨 解决 方法 。 

口 通过 requires static (参见 11.2 节 ) 指定 的 可 选 依赖 不 会 被 解析 。 它 们 需 
要 手动 添加 。 

口 不 允许 使 用 自动 模块 。 这 一 点 在 14.2 节 中 变 得 很 重要 ， 该 节 将 进行 详细 说 明 。 


除非 遇 到 诸如 丢失 或 重复 模块 之 类 的 问题 , 否则 已 解析 的 模块 ( 根 模块 加 上 传递 依赖 ) 将 最 
终 出 现在 新 的 运行 时 镜像 中 。 下 面 来 看 看 。 


14.1.2 ”镜像 内 容 和 结构 


要 事 第 一 : 与 263 MB 的 完整 有 下 E 相 比 , 此 镜像 在 Linux 上 仅 占用 约 45 MB( 据说 在 Windows 
上 甚至 更 少 ) 一 一 甚至 还 没 进行 14.4.2 节 中 将 讨论 的 镜像 大 小 优化 。 那 么 该 镜像 什么 样 呢 ? 6.3 
节 曾 介绍 过 新 的 JDK/JRE 目录 结构 ，jlink 创建 的 运行 时 镜像 与 其 相似 ， 如 图 14-1 所 示 。 这 不 
是 巧合 : 你 下 载 的 JDK 和 JRE 也 由 jlink 组装 。 
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类 似 .properties、.policy 











包含 eo 和 其 他 的 配置 文件 
fjlink 的 可 执行 文 文人 
jdk-9 Se 
加 bin 国 bin 
国 conf 国 conf 
国 include 人 ya 国 include 
国 jmods C 语 言 头 文件 国 legal 
图 legal 国 lib 
名 lib release 
| 
原始 的 平台 模块 ， 以 jmod 包含 nodules (所 有 模块 融合 
六 体形 起 存在 ， 在 镜像 中 。 进 同一 个 文件 ) 、 本 地 类 库 

















再 存在 ( 即 .dll 或 .so 文件 ) 以 及 其 他 

(.properties 、.policy) 

图 14-1 JDK 的 目录 结构 ( 左 ) 与 用 jlink 创建 的 自 定义 运行 时 镜像 ( 右 ) 之 间 
的 比较 。 相 似 并 非 偶然 一 一 JDK 是 使 用 jlink 创建 的 
































请 注意 ，jlink 将 选取 的 模块 融合 到 lib/modules 中 ， 然 后 从 最 终 镜 像 中 删除 jmods 目录 。 
这 与 JRE 的 生成 方式 一 致 ,JRE 也 不 包含 jmods。 原 始 的 JMOD 文件 仅 包含 在 JDK 申 以 便 jlink 
可 以 处 理 它们 : 将 模块 优化 至 lib/modules 是 一 个 不 可 道 操作 ， 并 且 jlink 无 法 从 已 优化 的 镜像 
中 生成 其 他 的 镜像 。 
查看 bin， 你 可 能 想 知道 在 其 中 可 以 找到 哪些 可 执行 文件 。 事 实证 明 ，j1link 很 聪明 ， 只 会 
在 生成 的 镜像 中 包含 所 需 模块 的 可 执行 文件 。 例 如 ， 用 于 编译 的 可 执行 文件 javac 是 随 着 
jdk.compiler 模块 一 起 提供 的 ， 如 果 不 包含 该 模块 ， 则 该 可 执行 文件 将 不 存在 


14.1.3 ”在 运行 时 镜像 中 包含 服务 


如 果 仔 细 查 看 代码 清单 14-1， 可 以 看 到 该 镜像 仅 包 含 java.base ， 这 似乎 有 点 奇怪 。 在 10.2.2 
节 中 ,你 了 解 到 基础 模块 使 用 了 许多 其 他 平台 模块 提供 的 服务 ,并且 在 模块 解析 期 间 绑 定 服务 时 ， 
所 有 这 些 提供 者 都 被 拉 和 人 了 模块 图 。 所 以 ， 为 什么 它们 没有 出 现在 镜像 中 呢 ? 

















定义 : --bind-services 

为 了 创建 小 型 的 、 专 用 的 运行 时 镜像 ， 默 认 情 况 下 jlink 创建 镜像 时 不 执行 任何 服务 绑 
定 。 相 反 ， 必 须 在 --add-modules 中 指定 ， 以 便 手 动 包含 需要 的 服务 提供 者 模块 。 另 外 ， 
--bindq-services 选项 可 用 于 包含 提供 一 个 服务 的 所 有 模块 , 该 服务 是 由 另 一 个 已 解析 的 模 
块 所 使 用 的 。 


让 我 们 以 ISO-8859-1、UTF-8 或 UTF-16 等 字符 集 为 例 。 基 础 模块 知道 你 通常 需要 的 模块 ， 
但 是 有 一 个 特殊 的 平台 模块 ， 其 中 包含 一 些 其 他 模块 : jdk.charsets。 基 础 模块 和 jdk.charsets 通过 
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14.1 创建 自 








服务 解 簿 。 以 下 是 其 模块 声明 的 相关 部 分 。 


module java.base { 
uses java.nio.charset.spi.CharsetProvider; 


} 


module jdk.charsets { 
provides java.nio.charset.spi.CharsetProvider 
with sun.nio.cs.ext.ExtendedCharsets 


} 


当 JPMS 在 常规 启动 期 间 解 析 模 块 时 ,服务 绑 定 将 拉 和 人 jdk.charsets ,因此 其 字符 集 在 标准 JRE 
中 并 不 总 是 可 用 。 但 是 当 你 通过 jlink 创建 一 个 运行 时 镜像 时 ， 服 务 绑 定 并 不 会 将 其 拉 人 ， 所 
以 镜像 默认 将 不 包含 charsets 模块 。 如 果 你 的 项 目 依赖 于 此 ， 则 可 能 会 以 非常 痛苦 的 方式 发 现 这 
个 问题 。 
一 旦 你 确定 要 依赖 一 个 通过 服务 解 耘 的 模块 时 ， 就 可 以 使 用 --adada-modqules 将 其 包含 在 镜 
像 中 。 
$ jlink 
--module-path $s{jdk-9}/jmods 
--add-modules java.base,jdk.charsets 


--output jdk-charsets 
$ jdk-charsets/bin/java --list-modules 












































> java.base 
> jdk.charsets 


定义 : --suggest-providers 

手动 识别 服务 提供 者 模块 可 能 很 麻烦 。 幸 运 的 是 ，jlink 可 以 帮助 你 。--suggest- 
providers S${service} 选 项 列 出 了 所 有 提供 ${service} 实 现 的 可 见 模块 ， 其 中 $s{service} 
必须 指定 完全 限定 名 。 


假设 你 已 经 创建 了 一 个 仅 包含 java.base 的 最 小 运行 时 镜像 ,并 且 由 于 缺少 字符 集 在 执行 应 用 
程序 时 遇 到 了 问题 。 你 定位 到 的 问题 是 java.base 使 用 了 java.nio.charset.spi.Charset- 
Provider， 现 在 想 知道 哪些 模块 提供 了 该 服务 。 下 面 该 --suggest-proviaqers 出 场 了 。 

S: (LTT 

--module-path $s{jdk-9}/jmods 
--Ssuggest-providers java.nio.charset.spi.CharsetProvider 




















> Suggested providers: 

2 jdk.charsets 

> provides java.nio.charset.spi.CharsetProvider 
> used by java.base 


另 一 个 可 能 导致 静默 缺失 模块 的 例子 是 语言 环境 ( locale )。 除 英语 语言 环境 外 ,所 有 其 他 语 
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言 都 包含 在 jdk.localedata 模块 中 ， 并 通过 服务 将 它们 提供 给 基础 模块 使 用 。 考 虑 以 下 代码 : 


String half = NumberFormat 
.getInstance (new Locale("fi", "FI")) 
format (0.55).; 

System.out .println (half); 





上 面 的 代码 将 打印 什么 输出 ?Locale ("fi"，"FI") 创 建 芬 兰 语 语言 环境 ， 而 芬兰 语 格 式 
使 用 带 逗 号 的 浮 点 数 ， 因 此 结果 为 0, 5 一 一 至 少 在 芬兰 语 语言 环境 可 用 时 是 这 样 。 如 果 你 在 不 包 
含 jdk.localedata 的 运行 时 镜像 上 执行 此 代码 ( 比如 你 之 前 创建 的 那个 镜像 )， 则 得 到 0 .5。 因 为 
Java 悄 无 声息 地 回 退 到 了 默认 语言 环境 。 是 的 ， 这 不 是 错误 ， 而 是 静默 的 不 良 行为 。 

和 之 前 一 样 ， 解 决 方案 是 显 式 包 括 那 些 已 解 耦 的 模块 ， 在 本 例 中 为 jdk.localedata。 但 是 ， 由 
于 它 包 含 许 多 语言 环境 数据 ， 因 此 使 得 镜像 大 小 增加 了 16 MB。 幸运 的 是 , 正如 你 将 在 14.4.2 节 
中 看 到 的 那样 ，jlink 可 以 帮助 减少 额外 的 负载 。 


注意 ”如 果 应 用 程序 的 行为 在 通用 的 Java 版 本 中 和 在 自 定 义 的 运行 时 镜像 上 运行 时 有 
所 不 同 ， 则 应 考虑 一 下 服务 。 行 为 不 正常 是 由 于 JVM 的 某 些 功能 不 可 用 引起 的 吗 ? 也 
许 其 中 的 模块 已 通过 服务 解 耦 ， 但 现在 在 运行 时 镜像 中 丢失 了 。 


下 面 是 基础 模块 会 使 用 并 由 其 他 平台 模块 提供 的 一 些 服 务 ， 你 可 能 隐 式 依赖 于 它们 : 
口 jdk.charsets 中 的 字符 集 
口 jdk.localedata 中 的 语言 环境 
口 jdk.zipfs 中 的 Zip 文件 系统 
口 java.naming 、java.security.jgss 、java.security.sasl 和 java.smartcardio 、java.xml.crypto 、 
jdk.crypto.cryptoki 、jdk.crypto.ec、jdk.deploy 和 jdk.security.jgss 中 的 安全 服务 提供 者 
作为 逐个 手动 标识 和 添加 模块 的 替代 方法 ， 可 以 使 用 更 方便 的 --bind-services 选项 。 
S$ jlink 
--module-path S${jdk-9}/jmods 
--add-modules java.base 
--bind-services 


--output jdk-base-services 
$s jdk-base-services/bin/java --list-modules 




















































































































> java.base 

> java.compiler 

> java.datatransfer 

> java.desktop 

# 以 下 省 略 了 另外 的 30 多 个 模块 信息 

















但 是 ,这 会 将 所 有 提供 服务 的 模块 绑 定 到 基础 模块 ， 从 而 创建 一 个 相当 大 的 镜像 一 一 (未 经 
优化 下 ) 该 镜像 约 为 130 MB 。 所 以 你 应 该 仔细 考虑 是 否 要 这 样 做 。 
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14.1.4 用 jlLink 和 jdeps 调 整 镜 像 大 小 


到 目前 为 止 , 你 仅 创建 了 由 java.base 和 其 他 一 些 模块 组 成 的 小 型 镜像 。 但 是 真实 世界 的 用 例 
呢 ? 你 如 何 确定 维持 大 型 应 用 程序 所 需 的 平台 模块 ” 不 能 再 用 试 错 法 了 ， 对 吧 ? 

这 就 引出 了 另 一 个 工具 一 一 JDeps。 关 于 JDeps 的 完整 介绍 ， 请 参见 附录 D 一 一 此 时 仅 需 了 
解 以 下 命令 将 列 出 应 用 程序 所 依赖 的 所 有 平台 模块 即 可 。 


jdeps -summary -recursive --class-path 'jars/*' jars/app.jar 


为 此 ，jars 目录 必须 包含 运行 应 用 程序 所 需 的 所 有 JAR ( 你 的 代码 以 及 相关 依赖 ; 构建 工具 
将 对 此 提供 帮助 )， 而 jars/app.jar 必须 包含 用 于 启动 的 main 函数 。 命 令 的 结果 会 显示 工件 之 间 
的 诸多 依赖 关系 ， 并 且 还 会 显示 平台 模块 的 依赖 。 以 下 示例 列 出 了 Hibernate Core 5.2.12 使 用 的 
平台 模块 及 其 依赖 项 。 


antlr-2.7.7.jar -> java.base 
classmate-1.3.0.jar -> java.base 
dom4j-1.6.1.jar -> java.base 


dom4j-1.6.1.jar -> java.xml 












































hibernate-commons-annotations-5.0.1.Final.jar -> java.base 
hibernate-commons-annotations-5.0.1.Final.jar -> java.desktop 
hibernate-core-5.2.12.Final.jar -> java.base 
hibernate-core-5.2 .Final.jar -> java.desktop 
hibernate-core-5. .Final.jar -> java.instrument 
hibernate-core-5. .Final.jar -> java.management 
hibernate-core-5. .Final.jar -> java.naming 
hibernate-core-5. .Final.jar -> java.sql 

hibernate-core-5. 
hibernate-core-5.2.12.Final.jar -> java.xml .bind 
hibernate-jpa-2.1-api-1.0.0.Final.jar -> java.base 


.Final.jar -> java.xml 





Ry Ry Te bh 
DODODODODOD 





hibernate-jpa-2.1-api-1.0.0.Final.jar -> java.instrument 








hibernate-jpa-2.1-api-1.0.0.Final.jar -> java.sql 
jandex-2.0.3.Final.jar -> java.base 
javassist-3.22.0-GA.jar -> java.base 
javassist-3.22.0-GA.jar -> jdk.unsupported 
jboss-logging-3.3.0.Final.jar -> java.base 
jboss-logging-3.3.0.Final.jar -> java.logging 
slf4j-api-1.7.13.jar -> java.base 


现在 你 需要 做 的 就 是 提取 这 些 行 ， 删除. . . -> 部 分 ， 并 且 扔 掉 重 复 项 。 对 Linux 用 户 来 说 ， 
需 执行 以 下 代码 。 

jdeps -summary -recursive --class-path 'jars/*' jars/app.jar 
| grep '\-> java.\|\-> jdk.' 


| seqd 's/~^.*-> //! 
| sort -u 


最 终 ,你 得 到 了 应 用 程序 所 依赖 的 完整 的 平台 模块 列表 .将 它们 输 到 jlink --add-modules 
中 ， 你 将 获得 支持 该 应 用 程序 的 最 小 运行 时 镜像 ， 如 图 14-2 所 示 。 
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类 赖 的 平台 模块 
依赖 的 平台 模 应 用 程序 JAR 
(普通 的 或 模块 化 的 ) 














真正 依赖 的 平台 模块 ， 平台 模块 
基于 此 创建 运行 时 镜像 
图 14-2 通过 给 定 应 用 程序 JAR ( 上 ) 及 其 在 平台 模块 上 的 依赖 (下 )， 
jlink 可 以 仅 基 于 需要 的 平台 模块 创建 运行 时 镜像 
































要 点 ”以 下 是 一 些 注意 事项 。 


口 JDeps 偶尔 会 报告 . .. -> not found， 这 意味 着 在 类 路 径 上 没有 某 些 传递 依 

赖 。 所 以 ， 请 确保 JDeps 的 类 路 径 包 含 运 行 应 用 程序 时 所 有 需要 使 用 的 工件 。 

口 JDeps 无 法 分 析 反 射 ， 因 此 ， 如 果 你 的 代码 或 你 的 依赖 代码 仅 通过 反射 与 JDK 
中 的 类 进行 交互 ，JDeps 则 不 会 对 此 进行 处 理 。 这 可 能 导致 所 需 的 模块 无 法 放 
入 镜像 中 。 

口 如 14.1.3 节 所 述 ， 默 认 情 况 下 ，j link 不 绑 定 服务 ， 但 是 你 的 应 用 程序 可 能 隐 

式 依赖 于 某 些 JDK 内 部 提供 者 。 

口 考虑 添加 支持 Java 代理 所 需 的 java.instrument 模块 。 如 果 你 的 生产 环境 使 用 代 

理 来 观察 正在 运行 的 应 用 程序 ， 则 这 是 必须 添加 的 。 即 使 不 是 这 种 情况 ， 你 也 

会 发 现 自 己 陷入 了 困境 ， 而 Java 代 理 是 分 析 问题 的 最 佳 方法 。 况 且 它 只 有 150 KB 

左右 ， 所 以 没什么 大 不 了 的 。 











注意 为 应 用 程序 创建 运行 时 镜像 后 ,建议 你 在 其 上 运行 单元 测试 和 集成 测试 。 这 将 使 
你 确信 确实 包括 了 所 有 必需 的 模块 。 


下 一 步 是 在 镜像 中 包含 应 用 程序 模块 一 一 但 要 做 到 这 一 点 , 你 的 应 用 程序 及 其 依赖 需要 完全 
模块 化 。 如 果 不 是 这 种 情况 ， 并 且 你 正在 寻找 更 直接 可 用 的 知识 ， 请 跳 至 14.3 节 以 生成 跨 操 作 
系统 的 运行 时 镜像 ， 或 跳 至 14.4 节 以 优化 镜像 。 


14.2 ”创建 独立 的 应 用 程序 镜像 


到 目前 为 止 , 你 已 经 创建 了 支持 应 用 程序 的 运行 时 镜像 , 但 没有 理由 就 此 止步 。jlink 使 创 
建 包含 整个 应 用 程序 的 镜像 变 得 容易 得 多 。 这 意味 着 , 你 最 终 将 获得 一 个 包含 应 用 程序 全 部 模块 
(应 用 程序 本 身 及 其 依赖 ) 和 文 持 它 的 平台 模块 的 镜像 。 你 甚至 可 以 创建 一 个 适合 的 启动 器 ， 因 
此 可 以 使 用 bin/my-app 运行 你 的 应 用 程序 ! 同时 ， 分 发 应 用 程序 也 变 得 更 加 容易 。 
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定义 : 应 用 程序 镜像 

为 了 清楚 地 描述 我 在 说 的 内 容 ， 我 将 包含 应 用 程序 全 部 模块 的 镜像 称 为 应 用 程序 镜像 
(application image， 与 之 相对 的 是 运行 时 镜像 )， 尽 管 其 不 是 官方 术语 。 人 毕竟 ， 生 成 的 结果 更 
类 似 于 应 用 程序 ， 而 非 通常 的 运行 时 环境 。 


要 点 ”请 注意 ,jl1link 仅 在 清晰 模块 上 运行 ， a 
程序 (参见 8.3 节 ) 链接 到 镜像 中 。 如 果 你 确实 必须 为 应 用 程序 创建 镜像 ,i 

阅 9.3.3 节 中 有 关 如 何 使 第 三 方 JAR 模块 化 的 方法 ， os 
开关 


> 











对 清晰 模块 的 这 种 限制 没有 技术 依据 一 一 这 是 由 设计 所 决定 的 。 应 用 程序 镜像 应 该 是 自 包 含 
的 ， 但 是 如 果 它 依赖 于 不 表达 依赖 关系 的 自动 模块 ， 则 JPMS 无 法 进行 验证 ， 因 此 可 能 会 导致 
NoClassDefFoundError。 这 与 模块 系统 所 追求 的 可 靠 性 相 违 背 。 

先决 条 件 解决 了 ， 让 我 们 开始 吧 。 首 先 创建 一 个 包含 应 用 程序 模块 的 镜像 (参见 14.2.1 前 ， 
然后 通过 创建 启动 程序 来 简化 工作 (参见 14.2.2 节 )， 最 后 考虑 一 下 应 用 程序 镜像 的 安全 性 、 性 
能 和 稳定 性 (参见 14.2.3 欧 。 


14.2.1 在 镜像 中 包含 应 用 程序 模块 


创建 应 用 程序 镜像 所 要 做 的 就 是 将 应 用 程序 模块 添加 到 jlink 模块 路 径 中 ， 并 从 中 选择 一 
个 或 多 个 作为 根 模 块 。 生 成 的 镜像 包含 所 有 需要 的 模块 ( 再 无 其 他 模块 ， 如 图 14-3 所 示 )， 可 以 
使 用 bin/java --module $f initial-module}) 命 令 启 动 。 

































































需要 的 平台 模块 


和 


应 用 程序 模块 















带 有 应 :用 程 月 模块 和 平台 模块 
贷 块 的 应 用 





14-3 ”给 定 应 用 程序 模块 (上 ) 及 与 平台 模块 的 依赖 关系 (下 )，jlink 可 以 仅 使 用 
所 需 的 模块 (包括 应 用 程序 和 平台 代码 ) 创建 运行 时 镜像 


作为 示例 ， 再 次 回 到 ServiceMonitor 应 用 程序 。 因 为 所 依赖 于 自动 模块 spark.core 和 
hibernate.jjpa， 但 jlink 不 支持 ， 所 以 我 不 得 不 去 掉 这 些 功能 。 这 就 给 我 们 留 下 了 7 个 模块 ， 所 
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有 的 模块 都 只 依赖 于 java.base: 


口 monitor 





口 monitor.observer 

口 monitor.observer.alpha 
口 monitor.observer.beta 
口 monitor.persistence 

口 monitor.rest 


口 monitor.statistics 


我 将 这 些 模块 放 入 名 为 mods 的 目录 中 , 并 创建 了 一 个 镜像 ， 如 代码 清单 14-2 所 示 。 不幸 的 























是 ， 我 忘记 了 观察 者 的 实现 ， 即 monitor observer.alpha 和 monitor.observer.beta 模块 ， 已 经 通过 服 








务 与 应 用 程序 的 其 余部 分 进行 了 解 而 ， 并 且 在 默认 情况 下 不 受 约束 ( 关于 服务 请 参考 第 10 章 ; 
关于 jlink 是 如 何 处 理 服务 的 请 参考 14.1.3 节 ) 因此 , 我 必须 在 代码 清单 14-3 中 再 次 尝试 显 式 
添加 。 或 者 , 也 可 以 使 用 --bind-services 选项 , 但 我 不 喜欢 由 于 包含 了 所 有 JDK 内 部 服务 提 
供 者 而 导致 镜像 变 得 过 大 。 





























代码 清单 14-2 ”创建 包含 ServiceMonitor 的 应 用 程序 镜像 
$ jlink 
--module-path S${jdk-9}/jmods:mods < 除了 平台 模块 ,我 还 在 mods 
--add-modules monitor | 目录 中 指定 了 应 用 程序 模 
--output jdk-monitor 块 。 在 Windows 中 使 用 “:” 
$s jdk-monitor/bin/java --list-modules 而 不 是 “:” 
> java.base 以 monitor 开始 解析 模块 
> monitor 
> monitor.observer 
> monitor.persistence 服务 实现 模块 monitor.observer.alpha 
> monitor.rest 和 monitor.observer.beta 丢失 
> monitor.statistics 
代码 清单 14-3 ”创建 包含 服务 的 应 用 程序 镜像 
$ jlink 


--module-path S${jdk-9}/jmods:mods 


=add= 


modules monitor, 


monitor.observer.alpha,monitor.observer.beta -| 
--output jdk-monitor 


monitor 


VV Vv VV VVvyV 


jdk-monitor/pbin/java --list-modules 


java.base 


monitor. 
monitor. 
monitor. 
monitor. 
monitor. 
monitor. 


以 初始 模块 《monitor〉 开始 
模块 解析 , 并 包含 所 有 需要 的 
模块 〈 其 他 两 个 ) 


observer 
observer.alpha 
observer.beta 
persistence 
rest 
statistics 
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定义 : 系统 模块 
总 的 来 说 , 镜像 包含 的 平台 和 应 用 程序 模块 称 为 系统 模块 。 稍 后 你 将 看 到 ， 在 启动 应 用 程 
序 时 仍然 可 以 添加 其 他 模块 。 


1. 当心 模块 解析 的 独特 性 

请 记 住 ， 在 14.1 节 中 ，jlink 创建 了 一 个 最 小 镜像 
口 它 不 绑 定 服务 ; 

口 它 不 包含 可 选 依赖 。 


要 点 尽管 你 会 记得 检查 自己 的 服务 是 否 存 在 ,但 可 能 会 忘记 依赖 (例如 SQL 
驱动 ) 或 平台 模块 (语言 环境 数据 或 不 常用 的 字符 集 )。 对 于 可 选 的 依赖 也 是 如 
此 ， 你 可 能 想 要 包含 这 些 依 赖 项 ， 但 是 忘记 了 一 个 事实 ， 即 可 选 依赖 不 会 因为 出 
a 参见 11.2.3 节 ), 务 必 确 保 真正 包含 了 所 有 需要 的 模块 ! 


ServiceMonitor 应 用 程序 使 用 芬兰 语 语言 环境 格式 化 其 输出 ， 因 此 需要 向 镜像 中 添加 
jdk.localedata 模块 ( 参见 代码 清单 14-4 )。 这 将 使 镜像 大 小 增加 16 MB (达到 61 MB )。14.4.2 节 
将 介绍 如 何 减 小 镜像 大 小 。 


代码 清单 14-4 用 语言 环境 数据 创建 ServiceMonitor 应 用 程序 镜像 
S jlink 
--module-path ${jdk-9}/jmods:mods 
--add-modules monitor, 
monitor.observer.alpha,monitor.observer.beta, 
jdk.localedata a 
--output jdk-monitor 








FE 台 模块 locales 也 被 添 
加 到 镜像 中 





2. 在 启动 应 用 程序 时 使 用 命令 行 选项 

一 旦 创建 了 镜像 ， 就 可 以 像 往常 一 样 使 用 java --module ${initial-module} 启 动 应 用 
程序 (使 用 镜像 bin 目录 中 的 java 可 执行 文件 )。 但 因为 你 在 镜像 中 包含 了 应 用 程序 模块 ， 所 以 
不 需要 指定 模块 路 径 一 一 JPMS 可 以 在 镜像 中 找到 它们 。 

在 jdk-monitor 中 创建 ServiceMonitor 镜像 之 后 ， 就 可 以 使 用 一 个 简短 的 命令 启动 应 用 程 
序 了 。 


$ jdk-monitor/bin/java --module monitor 


但 如 果 你 愿意 ， 则 可 以 使 用 模块 路 径 。 在 这 种 情况 下 ,请 记 住 系统 模块 ( 镜像 中 的 模块 ) 始 
终 履 盖 模 块 路 径 上 的 同名 模块 一 一 就 好 像 模块 路 径 上 的 模块 不 存在 一 样 。 你 能 够 对 模块 路 径 所 做 
的 是 向 应 用 程序 中 添加 新 模块 。 添加 的 模块 可 能 是 额外 的 服务 提供 者 , 这样 不 但 可 以 发 布 应 用 程 
序 的 镜像 ， 还 能 让 用 户 在 本 地 轻松 地 扩展 镜像 。 

假设 ServiceMonitor 发 现 了 一 个 需要 观察 的 新 的 微服 务 , 即 monitor.observer.zero 模块 。 此 外 ， 
该 模块 实现 了 所 有 正确 的 接口 ， 其 描述 符 声明 它 可 以 提供 serviceobserver。 然 后 ， 如 代码 清 



































292 第 14 章 通过 jlink 定制 运行 时 镜像 





单 14-5 所 示 ， 你 可 以 使 用 之 前 的 镜像 ， 并 添加 monitor.observer.zero 模块 。 


代码 清单 14-5 ”用 额外 的 服务 提供 者 启动 应 用 程序 镜像 


把 服务 提供 者 放置 在 并 不 是 真正 启动 应 用 程序 ， 而 是 查看 模块 解析 ， 
模块 路 径 中 以 检查 是 否 选 中 提供 者 (同时 ， 查 看 这 些 选项 是 
否 与 常规 JRE 一 样 工 作 ) 
--module-path mods/monitor.observer.zero.jar 
--show-module-resolution 
--dry-run 
--module monitor 
root monitor jrt:/monitor 


省 略 了 monitor 的 依赖 









$ jdk-monitor/bin/java 


monitor binds monitor.observer.alpha jrt:/monitor.observer.alpha 


monitor binds monitor.observer.beta jrt:/monitor.observer.beta 
monitor binds monitor.observer.zZero file://.. 





二 
jzrt: 字 符 串 表示 这 些 模 额外 的 模块 从 file: 指 定 
块 是 从 镜像 内 部 加 载 的 的 模块 路 径 加 载 

要 点 ”如果 你 想 替 换 系 统 模块 ,那么 必须 将 它们 放 在 升级 模块 路 径 上 (参见 6.1.3 





节 )。 除 了 模块 路 径 的 特殊 情况 外 ,本 书 提 到 的 所 有 其 他 java 选项 , 在 自 定义 应 
用 程序 镜像 中 都 是 相同 的 。 


14.2.2 ”为 应 用 程序 生成 一 个 本 地 启动 程序 
如 果 把 创建 一 个 包含 应 > 


么 自 定 义 添 加 启动 程序 就 像 是 蛋糕 上 的 糖衣 。 自 定义 启动 程序 是 镜像 bin 目录 中 的 可 执行 脚本 
( Unix 系统 上 的 shell; Windows 系统 上 的 batch ), 并 且 预 先 配 置 了 使 用 具体 模块 和 主 类 来 启动 JVM。 





应 用 程序 及 其 一 切 所 需 的 镜像 ( 而 不 包含 其 他 东西 ) 看 作 一 块 蛋糕 , 那 








定义 : --launcher 
要 创建 一 个 启动 程序 ， 需 使 用 --launcher ${name}=${module}/s{main-class} 选 项 
口 S{name} 是 你 为 可 执行 文件 选择 的 文件 名 ; 
口 Ss{module} 是 想 要 启动 的 模块 名 称 ; 
口 Stmain-class} 是 模块 的 主 类 名 。 


后 两 项 通常 放 在 java --module 之 后 ， 在 这 种 情况 下 ， 如 果 模 块 定 义 了 一 个 主 类 ， 那 么 
就 可 以 省 略 /$S{main-class}。 








如 代码 清单 14-6 所 示 ， 通 过 使 用 --launcher run-monitor=monitor， 你 可 以 让 jlink 
在 bin 中 创建 一 个 run-monitor 脚本 ,该 脚本 将 以 与 java --module monitor 等 价 的 方式 启 
动 应 用 程序 。 因 为 monitor 声明 了 主 类 (monitor .Main )， 所 以 不 必 再 通过 --launcher 指定 。 
如 果 你 想 要 指定 主 类 ， 可 以 使 用 --launcher run-monitor=monitor/ 




















monitor.Maino 
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代码 清单 14-6 ”使 用 启动 程序 创建 应 用 程序 镜像 并 稍 加 留意 
$ jlink < 
--module-path ${jdk-9}/jmods:mods | 生成 如 代码 清单 14-3 所 示 的 镜像 …… 
--add-modules monitor, 
monitor.observer.alpha,monitor.observer.beta | 除了 添加 一 个 启动 monitor 模块 
--output jdk-monitor (定义 主 类 ) 的 名 为 run-monitor 的 
--launcher run-monitor=monitor 4 启动 程序 
$s cat jdk-monitor/bin/run-monitor | 只 是 为 了 好 奇 而 查看 脚本 
> #!/bin/sh 人 (cat 打印 文件 内 容 ) 
JLINK_VM_OPTIONS= RS 
DIR=* Giriame S0、 shell 脚本 调用 脚本 时 
> 


执行 的 命令 





SDIR/java SJLINK_VM OPTIONS -m monitor/monitor.Main $s$@ 
$s jdk-monitor/bin/run-monitor | 如 何 使 用 启动 程序 


注意 ”你 是 否 注 意 到 代码 清单 14-6 中 的 JLINK_VM_OPTIONS? 如 果 想 为 应 用 程序 指定 
命令 行 选项 ， 例 如 调 优 垃圾 收集 器 ， 可 以 将 相应 的 选项 放 在 这 里 。 


不 过 ， 使 用 启动 程序 有 一 个 缺点 : 启动 VM le 选项 
之 后 ,并 视 为 程序 的 参数 。 这 意味 着 在 使 用 启动 程序 时 ,你 不 能 临时 配置 模块 系统 ,例如 ， 不 能 
像 前 面 讨论 的 那样 添加 其 他 服务 。 

但 有 一 个 好 消息 : java 命令 仍然 可 用 ， 因 而 你 不 必 使 用 启动 程序 。 即 使 创建 了 一 个 启动 程 
序 ， 代 码 清单 14-5 的 工作 方式 也 完全 相同 一 一 只 要 不 用 它 就 好 了 。 


14.2.3 ”安全 性 、 性 能 和 稳定 性 


创建 应 用 程序 镜像 可 以 通过 最 大 限度 地 减少 JVM 中 的 代码 量 来 提高 应 用 程序 的 安全 性 ， 从 
而 减少 攻击 面 。 正 如 14.4.3 节 将 讨论 的 ， 其 还 会 改善 启动 耗 时 。 

尽管 听 起 来 很 简单 , 但 它 只 适用 于 可 以 对 应 用 程序 完全 控制 并 定期 重新 部 署 的 情况 。 如果 你 
将 镜像 交付 给 客户 ， 或 者 无 法 控制 何 时 以 及 多 久 蔡 换 新 镜像 ， 那 么 情况 就 会 发 生变 化 。 


要 点 用 jlink 生成 的 镜像 并 不 适合 修改 , 它 没有 自动 更 新 功能 , 手动 打 补 丁 也 
是 不 现实 的 。 如 果 用 户 更 新 了 系统 的 Java， 你 的 应 用 程序 镜像 则 不 会 受到 影响 。 
总 之 ， 它 永远 绑 定 到 链接 期 间 平台 模块 的 Java 版 本 。 


好 处 是 Java 补丁 更 新 不 会 影响 应 用 程序 ， 但 更 严重 的 坏处 是 ， 应 用 程序 不 能 从 Java 新 版 本 
带 来 的 安全 补丁 或 性 能 改进 中 受益 。 如 果 在 新 的 Java 版 本 中 修补 了 一 个 关键 的 漏洞 ， 那 么 客户 
在 部 署 你 提供 的 新 应 用 程序 镜像 之 前 ， 仍 将 暴露 在 该 漏洞 所 带 来 的 威胁 之 下 。 


注意 ”如 果 你 决定 交付 应 用 程序 镜像 ， 建 议 你 将 其 作为 一 种 附加 的 交付 机 制 , 而 不 是 唯 
一 的 交付 机 制 。 让 用 户 决定 是 要 部 署 镜像 ， 还 是 在 自己 的 运行 时 上 运行 JAR, 这 样 他 们 
可 以 完全 控制 运行 时 环境 ， 并 且 可 以 独立 更 新 。 


Ey 
舍 
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14.3 ”生成 跨 操作 系统 的 镜像 


尽管 应 用 程序 和 类 库 JAR 包含 的 字 节 码 独立 于 任何 操作 系统 ， 但 是 它 需 要 一 个 特定 于 操作 系 
统 的 JVM 来 执行 。 这 就 是 为 什么 要 下 载 专门 针对 Linux、macOS 或 Windows 的 JDK 和 运行 时 。 重 
要 的 是 ， 要 认识 到 jlink 是 在 特定 于 操作 系统 上 操作 的 ! 图 14-4 显示 了 特定 于 操作 系统 的 部 分 。 














Java 开 发 通常 独立 于 任何 jlink 生 成 的 应 用 
具体 的 操作 系统 程序 镜像 不 再 是 系 
NN 统 无 关 的 
Applications \U 





Libraries 
Fra 





特定 于 操作 
系统 的 应 用 
程序 镜像 





JDK 是 特定 于 操作 系 
统 的 ，j1ink 操 作 在 
相同 的 级 别 上 


图 14-4 与 应 用 程序 、 类 库 和 框架 JAR ( 上 ) 不 同 ， 应 用 程序 镜像 ( 右 ) 
就 像 JVM (下 )， 是 特定 于 操作 系统 的 


仔细 想 想 就 会 发 现 : jlink 用 于 创建 镜像 的 平台 模块 来 自 特定 于 系统 的 JDK 或 JRE,， 
此 生成 的 镜像 也 是 特定 于 操作 系统 的 。 因 而 ,运行 时 或 应 用 程序 镜像 总 是 绑 定 到 某 个 具体 的 操 
作 系 统 。 

这 是 否 意味 着 ， 你 必须 在 一 堆 不 同系 统 的 机 带 上 执行 jlink 才能 创建 所 需 的 各 种 运行 时 或 
应 用 程序 镜像 ? 幸运 的 是 , 不 需要 这 样 做 。 正 如 你 在 14.1.1 节 中 看 到 的 ,在 创建 镜像 时 ， 可 以 将 
jlink 指向 你 希望 包含 的 平台 模块 。 实 际 情况 是 : 这 些 不 一 定 是 执行 jlink 所 在 的 操作 系统 ! 

















要 点 ”如 果 你 下 载 并 解压 了 一 个 不 同 操作 系统 的 JDK， 那 么 在 系统 JDK 上 运行 
jlink 时 ， 可 以 将 它 的 jmods 目录 放 在 模块 路 径 上 。 链接 器 将 确定 要 为 该 操作 系 
统 创建 镜像 ， 并 创建 在 该 操作 系统 上 工作 的 镜像 ( 当然 ,不 是 在 另 一 个 操作 系统 
上 )。 因 此 ， 给 定 应 用 程序 支持 的 所 有 操作 系统 的 JDK， 就 可 以 在 同一 台 机 器 上 
为 不 同系 统 生成 运行 时 或 应 用 程序 镜像 。 








我 使 用 Linux ， 但 是 我 想 生 成 一 个 在 macOS 上 运行 的 ServiceMonitor 应 用 程序 镜像 。j1ink 
可 以 方便 地 支持 这 些 场景 一 一 所 需 的 只 是 一 个 用 于 目标 操作 系统 的 JDK。 
事实 证 明 ， 最 难 的 部 分 是 将 JDK 在 不 同 的 系统 上 解 包 。 在 这 种 情况 下 ， 我 必须 解压 Oracle 
为 macOS 发 布 的 *.dmg 文件 一 一 在 这 里 不 做 详细 介绍 , 但 在 搜索 引擎 上 , 可 以 找到 关于 {Linux、 
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macoSs、Windows} 和 {rpm/tar.gz，dmg，exe} 各 种 组 合 的 建议 。 最 后 ， 我 在 某 个 目录 中 保存 
了 macOS JDK， 将 其 表示 为 ${jdk-9-mac-os}。 

接 下 来 要 做 的 事情 与 14.2.1 节 相 同 , 将 JDK9 目录 ($f{jdk-9} ) 蔡 换 为 包含 macOS JDK 的 目 
录 (${jdk-9-mac-os} )。 这 意味 着 我 使 用 的 jlink 可 执行 程序 来 自 Linux JDK, 但 jmods 目录 来 
自 macOS JDK。 











$ Jirik 
--module-path $s{jdk-9-mac-os}/jmods:mods 
--add-modules monitor, 
monitor.observer.alpha,monitor.observer.beta 
--output jdk-monitor 
--launcher run-monitor=monitor 


上 面 代码 的 运行 应 该 没 问题 。 


14.4 使 用 j1link 插件 优化 镜像 


“使 之 工作 ， 工 作 得 正确 ， 工 作 得 快速 "，Kent Beck ( 极限 编程 的 创建 者 和 《测试 驱动 开发 : 
实战 与 模式 解析 》 的 作者 ) 如 是 说 。 因 此 ， 在 介绍 了 创建 运行 时 和 应 用 程序 镜像 ( 甚至 跨 操 作 
系统 ) 的 细节 之 后 ,我 们 将 转向 优化 。 这 可 以 极 大 地 减 小 镜像 尺寸 ， 并 上 略微 提高 运行 时 性 能 ， 特 
别 是 启动 时 间 。 

在 jlink 中 ,优化 由 插件 处 理 。 因 此 ,在 使 镜像 更 小 (参见 14.4.2 节 ) 和 更 快 (参见 14.4.3 
节 ) 之 前 ， 有 必要 先 讨论 一 下 插件 架构 (参见 14.4.1 前 。 


14.4.1 jlLink 的 插件 


jlink 的 核心 是 它 的 模块 化 设计 。 除 了 选择 正确 的 模块 并 生成 镜像 的 基本 步 又 之 外 ，jLink 
将 镜像 的 进一步 处 理 留 给 了 插件 。 你 可 以 通过 jlink --1ist-plugins 查看 可 用 的 插件 ， 或 者 
查看 表 14-1 (我 们 将 在 14.4.2 节 和 14.4.3 节 中 查看 每 个 插件 )。 


表 14-1 字母 序 的 jlink 插件 列表 ， 指 明 插 件 是 减 小 镜像 大 小 还 是 提高 运行 时 性 能 
大 



































































































































名 你 描 述 小 性 能 
class-for-name 用 静态 访问 替换 class: :forName W 
compress 共享 字符 串 ， 压 缩 lib/modules Vv 
exclude-files 排除 文件 ， 例 如 二 进 制 文 件 v 
exclude-resources 排除 资源 ， 例 如 META-INF 目录 v 
generate-jli-classes 预 生 成 方法 句柄 v 
include-locales 从 jdk.localedata 中 剥离 非 本 地 的 语言 v 
order-resources 对 lib/modules 中 的 资源 排序 v 
strip-debug 从 镜像 字 节 码 中 删除 调试 符号 vv 





system-modules 准备 系统 模块 图 以 便 快速 访问 v 
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注意 文档 和 jlink 本 身 也 列 


出 了 vm 插件 ， 让 你 能 从 几 个 HotSpot 虚拟 机 (客户 机 、 


服务 器 或 最 小 虚拟 机 ) 中 选择 一 个 ， 并 包含 在 镜像 中 。 理论 上 这 是 可 行 的 ， 因 为 64 位 
JDK 只 与 服务 器 VM 一 起 发 布 。 大 多 数 情况 下 ， 你 只 有 一 个 选择 。 


1. 为 jlink 开发 插件 

















在 本 书 出 版 时 ， 只 有 支持 的 插件 是 可 用 的 , 但 当 添加 更 多 的 实验 功能 时 ， 这 一 点 在 未 来 可 能 
发 生 改 变 。 优 化 镜像 的 工作 还 处 在 开发 早期 ， 很 多 工作 仍 在 进行 中 。 由 于 没有 标准 化 ,也 没有 在 
Java 9 及 以 上 版 本 中 导出 ， 因 此 插件 的 API 将 来 可 能 会 改变 。 





这 使 得 为 link 开 发 插件 变 得 











E 常 复杂 “， 也 意味 着 在 社区 真正 开始 贡献 插件 之 前 ， 你 必须 


等 待 一 段 时 间 。 这 样 做 的 意义 是 什么 ” 首先 ， 编 写 jl ink 搬 件 有 点 像 编 写 代 理 程序 或 构建 工具 搬 
件 ， 而 不 是 在 开发 典型 的 应 用 程序 。 对 类 库 、 框 架 和 工具 的 支持 是 一 项 专门 的 任务 。 
但 是 让 我 们 回 到 社区 提供 的 插件 可 以 做 什么 的 问题 上 。 一 个 用 例 来 自 profilers， 它 使 用 代理 
将 性 能 跟踪 代码 注入 正在 运行 的 应 用 程序 中 。 使 用 jlink 插件 , 你 可 以 在 链接 的 时 候 完 成 注入 ， 
而 不 是 在 执行 应 用 程序 时 将 时 间 花 费 于 此 。 如 果 你 需要 快速 加 载 ,那么 这 可 能 是 一 个 明智 的 选择 。 
男 一 个 用 例 是 增强 Java Persistence API (JPA ) 实体 的 字 节 码 。 例 如 ，Hibemate 已 经 使 用 代 




































































理 来 跟踪 哪些 实体 发 生 了 变化 [ 所 谓 的 脏 检查 (dirty checking )]， 而 不 必 检 查 每 个 字段 。 这 在 链 

















接 时 而 非 启动 时 是 有 意义 的 ， 这 就 是 为 什么 Hibernate 已 经 为 构建 工具 和 IDE 提供 了 可 以 在 它们 


构建 过 程 中 实现 这 些 功 能 的 插件 。 


























最 后 一 个 例子 是 一 个 非常 好 的 、 有 潜力 的 jlink 插件 ， 此 插件 在 链接 时 索引 注解 并 使 该 索 


引 在 运行 时 可 用 。 这 将 大 大 减少 应 月 
解 的 bean 实体 。 


2. 使 用 jlink 插件 














程序 的 启动 时 间 , 这 些 应 用 程序 将 扫描 模块 路 径 以 查找 带 注 





定义 : 插件 命令 行 选项 --$ {name} 
掌握 了 理论 知识 ， 现 在 让 我 们 真正 使 用 一 些 插件 吧 。 插 件 的 使 用 非常 简单 : jlink 根据 
每 个 插件 的 名 称 自动 创建 一 个 命令 行 选项 --$ {name}。 进 一 步 的 参数 传递 取决 于 插件 ， 并 在 


Te ST ee ol i 























$9 Link 


了 描述 。 





去 除 调试 符号 是 减 小 镜像 尺寸 的 好 方法 ， 为 此 ,使 用 --strip-depbug 来 创建 镜像 。 


--module-path $s{jdk-9}/jmods 


--add-modules java.base 
--strip-debug 


--output jdk-base-stripped 


这 样 就 可 以 了 : lib/modules 中 的 基本 模块 大 小 从 23 MB 压缩 到 了 18 MB (在 Linux 也 。 














Q 如 果 你 有 兴趣 对 此 进行 代码 走 查 ， 











请 参见 Gunnar Morling 的 博客 文章 “Exploring the jlink Plug-in API in Java 9”。 
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通过 把 重要 文件 放 在 前 面 来 对 lib/modules 中 的 内 容 进行 排序 可 以 减少 启动 时 间 〈 尽管 我 怀 
疑 效果 是 否 明史 。 
$s jlink 
--module-path S${jdk-9}/jmods 
--add-modules java.base 


--order-resources=**/module-info.class,/java.base/java/lang/** 
--output jdk-base-ordered 


这 样 ， 首 先是 模块 描述 符 ， 然 后 是 java .1ang 包 中 的 类 。 

既然 你 已 经 知道 了 如 何 使 用 插件 , 现在 就 该 测试 一 些 插 件 了 。 我 们 将 分 两 个 部 分 进行 讲解 ， 
第 一 部 分 关注 缩减 尺寸 (参见 14.4.2 节 )， 第 二 部 分 关注 性 能 改进 ( 参见 14.4.3 节 )。 因 为 这 是 
一 个 不 断 演变 的 特性 ， 同 时 也 是 相当 专业 的 特性 ， 所 以 我 不 会 详细 介绍 官方 的 jlink 文档 和 
jlink --1ist-plugins， 而 是 尽量 用 尽 可 能 少 的 文字 进行 讲解 ， 但 更 精确 地 展示 它们 的 用 法 。 


14.4.2 ” 减 小 镜像 尺寸 


让 我 们 逐个 检查 缩小 尺寸 的 插件 并 测量 它们 的 效果 。 我 本 想 在 应 用 程序 镜像 上 测试 它们 , 但 
ServiceMonitor 只 有 大 约 12 个 类 ， 所 以 减 小 它 的 尺寸 毫 无 意义 。 我 找 不 到 一 个 可 以 免费 使 用 且 完 
全 模块 化 的 应 用 程序 ， 包 括 它 的 依赖 。( 在 镜像 中 没有 自动 模块 ， 还 记得 吗 ? ) 相反 ， 我 将 对 这 
3 个 不 同 的 运行 时 镜像 上 的 工作 量 进行 衡量 (括号 中 为 变更 前 的 尺寸 ): 











































































































口 base 仅 包 含 java.base (45 MB ); 
D services 一 一 java.base 加 上 所 有 的 服务 提供 者 ( 150 MB ); 
口 java 一 一 所 有 java.* 和 javafx.* 模 块 ， 但 不 包括 服务 提供 者 (221 MB )。 





有 趣 的 是 , java 相对 于 services 具有 更 大 的 尺寸 并 不 是 由 于 更 多 的 字 节 人 码 ( lib/modules 在 java 
中 比 在 services 中 更 小 一 些 )， 而 是 由 于 本 地 库 ， 尤 其 是 为 JavaFX 的 WebView 所 捆绑 的 WebKit 
代码 。 这 将 在 试图 减 小 镜像 尺寸 时 帮助 你 理解 插件 的 行为 。( 顺便 提 一 下 ， 我 正在 为 Linux 做 这 
件 事情 ,但 是 其 他 操作 系统 的 比例 应 该 也 差不多 。 ) 


1. 压缩 镜像 


计 











定义 : 压缩 插件 
压缩 插件 意 在 减 小 lib/modules 的 尺寸 。 它 通过 --compress=${value} 选 项 来 控制 , 包含 
3 个 合法 值 : 
口 0 一 一 不 压缩 ( 默认 ); 
口 1 一 一 去 重 并 且 共 享 字 符 串 内 容 ( 意 为 String s = "text"; 中 的 "text"); 
口 2 一 一 利用 Zip 对 lib/modules 进行 压缩 。 
可 以 通过 --compress=${value}:filter=${pattern-list} 来 包含 一 个 可 选 样式 列 
表 ， 用 来 仅 压缩 匹配 这 些 样式 的 文件 。 
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该 命令 创建 了 一 个 仅 包含 基础 模块 的 压缩 后 的 运行 时 镜像 。 


S jlink 
--module-path $s{jdk-9}/jmods 
--add-modules java.base 
--output jdk-base 
--Compress=2 


很 明显 ， 你 不 需要 尝试 0。 对 于 1 和 2， 我 得 到 了 以 下 结 
口 base 43 MB 一 39MB (1) 一 33MB (2) 

口 Services 一 一 130MB 一 119MB (1) 一 91MB (2) 

口 java 221 MB 一 189MB (1) 一 104MB (2) 

可 以 看 到 ， 压 缩 率 对 于 每 个 镜像 是 不 一 样 的 。services 镜像 尺寸 可 以 被 减 小 将 近 40%， 但 更 
大 的 java 镜像 只 减 小 了 25%。 这 是 由 于 compress 插件 仅 对 lib/modules 有 效 ， 正 如 我 们 所 讨论 
的 ， 它 在 两 个 镜像 中 几乎 都 是 相同 的 尺寸 。 因 此 ,， 减 小 的 绝对 尺寸 是 相近 的 : 对 于 每 个 镜像 都 是 
大 约 60 MB， 超 过 lib/modules 初始 尺寸 的 50%。 


















































注意 通过 --compress=2 指定 的 Zip 压缩 会 增加 启动 时 间 总 的 来 说 ， 镜 像 越 大 ， 
增加 的 时 间 越 多 。 如 果 启 动 时间 对 你 来 说 很 重要 ， 那 么 请 确保 关注 它 所 带 来 的 影响 


2. 排除 文件 和 资源 
定义 : exclude-files 与 exclude-resources 插件 


exclude-files 和 exclude-resources 插件 允许 将 文件 从 镜像 中 排除 。 相 应 的 选项 --exclude- 
files=${pattern-list} 和 --exclude-resources=s{pattern-list} 接 受 一 个 样式 列 


表 ， 用 来 匹配 要 排除 的 文件 。 





如 同 我 在 比较 services 和 base a 1 的 ， 主 要 是 JavaFX WebvView 的 二 进 
制 字 节 码 导 致 了 java 的 尺寸 变 大 。 在 我 的 机 器 上 ， 它 是 一 个 73 MB 的 lib/libjfxwebkit.so 文件 。 
下 面 演 示 了 如 何 通 过 --exclude-files 将 它 排除 。 








$ jlink 
--module-path S${jdk-9}/jmods 
--add-modules java.base 
--output jdk-base 
--exclude-files=**/1ibjfxwebkit.so 



































这 实现 了 将 镜像 减 小 73 MB 的 效果 。 下 面 是 两 个 告 诚 : 
口 这 了 人 二 洛 避 们 信 铭 你 中 出 际 和 有 守 相同 效果 ; 
口 这 使 得 只 包含 WebView 的 javafx.scene.web 模块 几 近 于 无 用 ,所 以 更 好 的 选择 是 不 要 包含 


这 个 模块 。 
除了 实验 和 学 习 , 排除 来 自 于 平台 模块 的 内 容 是 糟糕 的 实践 。 一定 要 对 任何 这 样 的 决定 进行 
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深入 研究 ， 因 为 这 有 可 能 影响 JVM 的 稳定 性 。 

对 这 些 插件 更 好 的 用 法 是 ， 将 应 用 程序 或 依赖 JAR 所 包含 但 在 应 用 程序 镜像 中 不 需要 的 文 
件 进行 排除 。 可 以 是 文档 、 不 需要 的 源 代码 文件 、 不 需 关 心 的 针对 操作 系统 的 二 进 制 字 节 码 、 配 
置 或 者 任何 被 别 具 匠 心 的 开发 者 放 入 归档 文件 中 的 东西 。 对 于 压缩 尺寸 的 比较 也 是 没有 意义 的 : 
被 排除 文件 所 占 的 空间 会 被 节省 出 来 。 

3. 排除 不 需要 的 语言 环境 

语言 环境 确实 是 值得 删除 的 来 自 于 平台 模块 的 内 容 。 正 如 你 在 14.1.3 节 所 发 现 的 ,基础 模块 
仅 能 在 英语 语言 环境 中 工作 ， 而 jdk.localedata 模块 包含 了 Java 所 支持 的 所 有 其 他 语言 环境 。 很 
不 科 , 这 些 语 言 环境 加 在 一 起 大 约 有 16 MB 。 如 果 你 只 需要 一 个 或 者 几 个 非 英 语 语言 环境 , 那 这 
个 尺寸 还 是 有 点 大 。 


















































定义 : include-locales 插件 

include-locales 插件 的 作用 是 这 样 的 一 一 通过 --include-locales=${langs} 选 项 生成 
的 镜像 将 仅 包含 它 所 指定 的 语言 环境 , 其 中 ${1angs} 是 一 个 过 号 分 隔 的 BCP 47 语言 标签 ( 类 
似 于 en-US、zh-Hans 和 fi-FI ) 列表 。 

该 插件 只 在 某 个 语言 环境 被 jdk.localedata 模块 放 入 镜像 时 才 有 效果 ,所 以 它 不 会 包括 除 基 
础 模块 所 附带 的 语言 环境 之 外 的 其 他 语言 环境 ,这 是 因为 它 会 排除 jdk.localedata 中 的 所 有 其 他 


语言 环境 。 


代码 清单 14-4 创建 了 一 个 ServiceMonitor 的 应 用 程序 镜像 ， 其 包含 了 所 有 的 jdk.localedata， 
为 该 应 用 程序 在 输出 中 使 用 了 芬兰 语 格 式 。 这 使 得 镜像 尺寸 额外 增加 了 16 MB, 而 你 清楚 如 何 
将 它 减 小 回来 。 代码 清单 14-7 通 过 使 用 --incluaqe-locales=fi-FI 来 达到 此 目的 。 相 对 于 没有 
使 用 jdk.localedata 的 镜像 , 由 此 创建 的 镜像 的 尺寸 只 进行 了 最 小 限度 的 增加 ( 准确 地 说 , 168 KB )。 
成 功 ! 


代码 清单 14-7 创建 带 有 芬兰 语 语言 环境 的 ServiceMonitor 应 用 程序 镜像 
$s jlink 
--module-path ${jdk-9}/jmods:mods 
--add-modules monitor, 
monitor.observer.alpha,monitor.observer.beta, 




















jdk.localedata 本 
--output jdk-monitor 
> --include-locales=fi-FI 需要 显 式 (如同 本 例 ) 或 隐 式 (通过 requires 
除 人 FI (芬兰 语 ) 之 外 的 所 有 语言 环境 引 令 或 者 --bind-services 选项 ) 地 将 语言 
都 被 从 jdk.localedata 中 列 离 环境 的 平台 模块 添加 到 镜像 中 








通过 排除 语言 环境 能 够 减少 多 少 镜像 尺寸 依赖 于 你 需要 多 少 种 语言 环境 。 如 果 是 将 一 个 国际 
化 的 应 用 程序 交付 给 一 个 全 球 性 的 客户 ,那么 将 无 法 节省 太 多 尺寸 ,但 我 认为 这 种 情况 并 不 常见 。 
如 果 应 用 程序 只 支持 少数 或 者 甚至 十 儿 种 语言 , 那么 将 其 他 语言 排除 会 节省 几乎 16 MB。 这 个 努 
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力 是 否 值得 由 你 做 主 。 


4. 剥离 调试 信息 

当 你 用 IDE 调试 Java 代码 时 ， 通 常会 看 到 精致 的 被 格式 化 、 命 名 甚至 注释 过 的 源 代码 。 这 
是 由 于 IDE 获取 了 相应 的 真实 源 文件 , 将 它们 绑 定 到 当前 正 被 执行 的 字 节 码 , 并 且 适 宜 地 显示 了 
出 来 。 这 是 最 佳 场景 。 

在 没有 源 文 件 时 ， 如 果 除 了 字段 和 方法 参数 名 ( 必定 存在 于 字 节 码 中 ) 还 能 看 到 变量 名 ( 不 
是 必须 存在 于 字 节 码 中 )， 也 许 你 仍然 可 以 看 到 具有 良好 可 读 性 的 代码 。 如 果 反 编译 代码 包含 调 
试 符号 ， 就 会 出 现 这 种 情况 。 这 个 信息 使 得 调试 更 容易 ， 但 当然 也 会 占用 空间 。 而 jlink 允许 
你 将 这 些 符号 剥离 。 





















































定义 : strip-debug 插件 
如 果 通 过 --strip-debug 选项 激活 jlink 的 strip-debug 插件 ， 那 么 它 将 从 镜像 的 字 节 
码 中 删除 所 有 的 调试 信息 ， 进 而 减 小 lib/modules 文件 的 尺寸 。 此 选项 没有 其 他 参数 。 





我 在 14.4.1 节 中 使 用 过 --strip-debug 选项 ， 所 以 在 此 就 不 蒙 述 了 。 来 看 一 下 它 是 如 何 减 
小 镜像 尺寸 的 : 
口 base 45 MB 一 40 MB 
口 services——150 MB 一 130 MB 
221 MB 一 200 MB 
这 相当 于 镜像 总 尺寸 的 10%， 但 是 请 记 住 ， 这 只 影响 了 lib/modules ， 其 减 小 了 大 约 20%。 














口 java 


要 点 “一 点 警告 : 在 没有 源 文件 和 调试 符号 的 情况 下 调试 代码 是 一 件 非 常 可 怕 的 
事情 。 也 许 你 偶尔 会 通过 远程 调试 连接 到 一 个 正在 运行 的 应 用 程序 ， 并 且 分 析出 
现 的 问题 ， 如 果 放 弃 了 那些 调试 符号 ， 你 则 不 会 很 开心 ， 尤 其 是 当 节省 的 那 几 兆 
字 节 对 你 来 说 并 不 重要 的 时 候 。 小 心 考虑 --strip-depbug! 





5. 将 这 些 选项 放 在 一 起 
虽然 将 文件 和 资源 排除 对 于 应 用 程序 模块 来 说 会 更 好 , 但 其 他 选项 在 纯 运行 时 镜像 中 运行 良 
好 。 让 我 们 把 它们 放 在 一 起 ， 并 且 尝 试 为 挑选 出 来 的 这 3 个 模块 创建 最 小 的 镜像 。 下 面 仅 是 


java.base 的 命令 行 。 








$ jlink 
--module-path $s{jdk-9}/jmods 
--add-modules java.base 
--output jdk-base 
--Compress=2 
--strip-debug 


这 是 执行 的 结 
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口 base 一 一 45 MB 一 31 MB 
口 services 一 一 150 MB 一 75 MB (我 同时 删除 了 除 fi-FI 之 外 的 所 有 语言 环境 ) 
口 java 一 一 221 MB 一 155 MB (或 者 82 MB ， 如 果 去 除 JavaFX WebKit 的 话 ) 
这 个 结果 不 坏 ， 是 吧 ? 


























14.4.3 ”提高 运行 时 性 能 


如 你 所 见 , 减 小 应 用 程序 或 运行 时 镜像 尺寸 的 方法 有 很 多 。 我 的 猜测 是 ， 大 多 数 开 发 者 在 急 
切 地 盼望 着 性 能 的 提高 ， 尤 其 是 在 Spectre 和 Meltdown 抢 走 了 一 些 CPU 周期 后 。 








加 |， 要 点 ”很 不 在， 在 这 个 领域 我 没有 太 多 好 消息 : 基于 jlink 的 性 能 优化 仍然 处 于 
矢 角 早期 阶段 ， 而 已 有 的 大 多 数 或 者 已 经 预期 的 优化 集中 于 提升 启动 时 性 能 ， 而 非 长 
期 运行 时 的 性 能 。 


一 个 现 有 的 插件 是 system-modules。 它 默认 被 打开 ， 会 预先 计算 系统 模块 图 并 且 将 之 存储 ， 
以 便 快 速 访问 。 这 样 ，JVM 就 不 需要 在 每 次 启动 时 都 解析 和 处 理 模块 声明 以 及 验证 可 靠 配置 了 。 

另 一 个 搬 件 是 class-forname ， 它 用 some.Type.class 来 奉 换 诸如 Class.forName 
("some .Type") 这 样 的 字 节 码 , 进而 相对 昂贵 且 基 于 反射 的 按 名 称 对 类 进行 的 搜索 则 可 以 避免 。 
我 们 简要 地 看 过 order-resources， 其 并 没有 对 性 能 有 较 大 的 改善 。 

目前 , 唯一 支持 的 其 他 性 能 相关 的 插件 是 generate-jli-classes。 合 理 配 置 后 ， 它 可 以 将 初始 化 
lambda 表达 式 的 代价 从 运行 时 移动 到 链接 时 , 但 需要 对 方法 句柄 有 很 好 的 理解 后 , 才能 有 效 对 它 
进行 学 习 ， 所 以 我 不 会 在 此 过 多 涉及 这 个 话题 。 

这 就 是 性 能 提升 相关 的 所 有 内 容 。 如 果 你 对 于 在 此 领域 没有 获得 太 多 帮助 而 很 失望 , 对 此 我 
表示 理解 。 但 是 请 让 我 指出 ，JVM 已 经 优化 的 非常 彻底 了 。 所 有 低 垂 的 果实 (以 及 一 些 相对 较 
高 的 果实 ) 都 已 经 被 摘 掉 了 ， 而 要 摘 取 剩 下 的 果实 还 需要 精巧 的 设计 、 大 把 的 时 间 以 及 专业 的 工 
程 能 力 。jlink 工具 仍然 年 轻 ， 我 相信 JDK 开发 团队 和 社区 会 在 适当 的 时 候 对 它 加 以 利用 。 

































































Java 10 的 应 用 程序 类 数据 共享 

Java 10 引入 了 一 个 与 jlink 间 接 相关 的 优化 : 应 用 程序 类 数据 共享 。" 实 验证 实 ， 它 可 以 
使 得 应 用 程序 启动 加 快 10% 到 50%。 有 趣 的 是 ， 你 可 以 在 应 用 程序 镜像 中 应 用 这 项 技术 ， 创 
建 一 个 更 加 优化 的 部 署 单元 。 


14.5 ”jlink 选项 








方便 起 见 , 表 14-2 列 出 了 本 书 讨论 的 所 有 jlink 命令 行 选项 。 更 多 信息 可 以 参见 官方 文档 ， 
或 者 使 用 jlink --help 和 jlink --list-plugins。 














人 参见 我 的 博客 文章 “Improve Launch Times on Java 10 with Application Class-Data Sharing” 来 了 解 更 多 信息 。 
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表 14-2 ”经 筛选 的 jlLink 字母 序 选项 列表 ， 包 括 插件 。 描 述 列 基于 官方 文档 ， 引 用 列 指向 本 书 
中 详细 解释 如 何 使 用 这 些 选项 的 章节 














































































































选 项 描 述 引 用 
es 为 镜像 内 容 定义 根 模块 1411 节 
--pina-services 包含 所 解析 模块 使 用 的 所 有 服务 提供 者 14.1.3 节 
-~-class-for-name 用 静态 访问 〈 插件 ) 替换 class :forName 14.4.3 市 
--compress、-c 共享 字符 串 内 容 ， 压 缩 lib/modules( 插件 ) 14.4.2 节 
--exclude-files、 排除 指定 的 文件 和 资源 (插件 ) 14.4.2 他 
--exclude-resources 
--generate-jli-classes ” 预 生成 方法 句柄 ( 插件 ) 14.4.3 市 
--include-locales 从 jdk.localedata 中 剥离 所 有 语言 环境 ， 指 定 的 语言 环境 除外 (插件 ) 14.4.2 节 
--launcher 在 bin 中 为 应 用 程序 生成 一 个 本 地 启动 器 脚本 14.2.2 节 
--list-plugins 列 出 可 用 插件 14.4.1 市 
--module-path、-p 指定 从 哪儿 查找 平台 和 应 用 程序 模块 14.1.1 节 
--order-resources 在 lib/modules 中 预定 资源 (插件 ) 14.4.1 市 
-ute 在 指定 位 置 生成 镜像 14.1.1 节 
~-strip-debug 从 镜像 字 节 和 码 中 移 除 调试 镜像 〈 插件 ) 14.4.2 他 
二 为 指定 服务 列 出 可 见 模块 14.13 节 

14.6 小结 








口 命令 行 工 具 jlink 基于 指定 的 平台 模块 创建 运行 时 镜像 (使 用 jdeps 来 确定 应 用 程序 需 
要 哪些 平台 模块 )。 要 从 这 个 工具 中 受益 ， 应 用 程序 需要 运行 于 Java 9 及 以 上 版 本 ， 但 模 
块 化 不 是 必需 的 。 

口 一 旦 应 用 程序 和 依赖 被 完全 模块 化 ( 而 非 利 用 自动 模块 )，j1ink 就 可 以 为 它 创建 应 用 程 

序 镜像 ， 其 中 包含 应 用 程序 的 模块 。 

口 所 有 对 jlink 的 调用 都 需要 指定 以 下 参数 。 

@ --module-path， 从 哪里 查找 模块 (包括 平台 模块 )。 
四--add-modules， 所 解析 的 根 模块 。 
四 --OUutput,， 生成 镜像 的 输出 目录 。 
口 注意 jlink 如 何 解 析 模 块 。 
和 不 会 默认 绑 定 服务 。 
昌 zecquires static 指定 的 可 选 依赖 不 会 被 解析 。 
和 不 允许 使 用 自动 模块 。 
和 确保 通过 --add-modules 单独 地 增加 依赖 的 服务 提供 者 或 者 可 选 依赖 ， 或 者 通过 
--bind-services 绑 定 所 有 服务 提供 者 。 









































14.6 小结 303 





口 当心 那些 无 须 实现 就 可 以 隐 式 依赖 的 平台 服务 。 比 如 字符 集 (jdk.charsets )、 语 言 环境 

(jdk.localedata )、Zip 文件 系统 (jdk.zipfs ) 以 及 安全 提供 者 ( 多 个 模块 )。 

口 由 jlink 生成 的 运行 时 镜像 。 

和 绑 定 到 通过 --modqule-path 选择 的 平台 模块 构建 所 针对 的 操作 系统 。 
四 与 JDK 和 了 RE 有 相同 的 目录 结构 。 

和 将 平台 和 应 用 程序 模块 ( 统称 为 系统 模块 ) 融合 进 lib/modules。 

@ 仅 包 含 所 需 模块 的 二 进 制 文件 (在 bin 目录 中 )。 

口 使 用 pbin/java --module Ss{initial-module} (无 须 模块 路 径 ， 因 为 系统 模块 被 自 
动 解析 ) 或 者 通过 --launcher $s{name}=${module}/${main-class} 创 建 的 启动 器 
来 启动 应 用 程序 镜像 。 

口 利用 应 用 程序 镜像 ， 模 块 路 径 可 以 用 来 增加 额外 的 模块 ( 尤其 是 那些 提供 服务 的 模块 )。 

模块 路 径 中 与 系统 模块 同名 的 模块 会 被 忽略 。 

口 当 你 很 难 对 所 交付 应 用 程序 镜像 的 安全 、 性 能 以 及 稳定 性 进行 更 新 时 ， 请 仔细 评估 这 些 

指标 。 

口 很 多 jlink 选项 通过 激活 相关 插件 提供 减少 镜像 尺寸 (例如 --compress、--exclude- 
files、--exclude-resources、--include-locales 以 及 --strip-debug ) 或 者 
改进 性 能 ( 大 多 数 是 启动 时 ，--class-for-name、--generate-jli-classes 以 及 
--order-resources ) 的 方法 。 未 来 可 以 期 待 更 多 ， 此 领域 现在 仍然 处 于 早期 阶段 。 

口 在 早期 阶段 ，jlink 插件 API 尚未 被 标准 化 以 推动 其 演进 ， 所 以 开发 和 使 用 第 三 方 插件 

的 难度 很 大 。 









































完成 拼图 








本 章 内 容 

口 一 个 精心 装饰 过 的 ServiceMonitor 版 本 

口 是 否 使 用 模块 

口 理想 的 模块 什么 样 

口 使 模块 声明 保持 整洁 

口 模块 系统 与 构建 工具 、OSGi 和 微服 务 对 比 

















既然 本 书 已 经 涵盖 了 有 关 模 块 系统 的 几乎 所 有 知识 , 那么 现在 就 该 进行 总 结 了 。 在 最 后 这 一 
章 ， 我 想 把 这 些 “碎片 ”连接 起 来 ， 并 针对 如 何 创 建 出 色 的 模块 化 应 用 程序 提出 一 些 建 议 。 

本 章 会 先 展示 一 个 ServiceMonitor 应 用 程序 的 例子 ， 以 说 明 本 书 讨论 的 各 种 特性 是 如 何在 一 
起 协同 工作 的 (参见 15.1 节 )。 然 后 会 深入 探讨 一 些 更 常见 的 问题 ,来 帮助 你 决定 是 否 要 创建 模 
块 、 这 样 做 的 目的 ， 以 及 如 何 小 心地 改进 模块 声明 以 使 它们 保持 整洁 (参见 15.2 节 )。 最 后 我 会 
回顾 模块 系统 的 技术 全 貌 (参见 15.3 节 )， 以 及 对 Java 模块 化 生态 系统 的 愿景 (参见 15.4 节 )， 
并 以 此 来 结束 全 书 。 






































15.1 为 ServiceMonitor 添加 装饰 


第 2 章 剖 析 过 ServiceMonitor 应 用 程序 的 内 部 细节 。 在 2.2 节 ， 你 创建 了 仅 使 用 requires 
和 exports 基本 指令 的 简单 模块 。 至此， 本 书 不 但 讨论 了 相关 的 细节 ， 还 探索 了 一 些 更 高 级 的 
模块 系统 特性 ， 对 它们 逐一 进行 了 学 习 ， 但 是 现 在 我 想 把 它们 放 到 一 起 。 

为 了 全 面 感 受 ServiceMonitor 应 用 程序 , 请 签 出 代码 库 中 的 features-combined 分 支 。 代 
码 清单 15-1 包含 了 ServiceMonitor 中 所 有 模块 的 声明 。 


代码 清单 15-1 使 用 了 贯穿 本 书 所 有 高 级 特性 的 ServiceMonitor 应 用 程序 


monitor.observer.utils 主要 用 于 观察 者 的 实现 ， 所 以 它 

仅 被 导出 到 部分) 观察 者 的 实现 参见 15.1.2 节 ) 
module monitor.observer { 

exports monitor.observer; 

exports monitor.observer.utils 














15.1 ”为 ServiceMonitor 添加 装饰 305 





to monitor.observer.alpha, monitor.observer.beta; 


! 通过 服务 来 将 消费 者 (monitor) 和 观察 者 
Ee i ee API 的 实现 (例如 monitor.observer.alpha) 
moQule moniltor.observer.alipnNa 进行 解 耦 (参见 15.1.3 节 ) 


requires monitor.observer; 
provides monitor.observer.ServiceObserverFactoryg 
with monitor.observer.alpha.AlphaServiceObserverFactory; 





} monitor.observer.beta 和 monitor.observer.gamma 没有 
在 此 展示 ， 它 们 和 monitor.observer.alpha 很 相像 





// [...] > 


module monitor.statistics { 


Fei Deansit Live monitor.observer; 某 些 模块 通过 API 将 另 一 个 模块 的 类 
requires static stats.fancy; 十 ] 型 公开 ， 并 且 没有 另外 那个 模块 就 无 
exports monitor.statistics; 法 工作 ， 所 以 它们 隐 式 表明 可 读 性 
(参见 15.1.1 节 ) 
module stats.fancy { 
exports stats.fancy; stats.fancy 没有 出 现在 每 个 部 署 中 ， 相 应 
} 地 ，monitor.statistics 将 对 这 个 模块 的 依 





赖 标识 为 可 选 依 赖 〈 参 见 15.1.1 节 ) 


module monitor.persistence { 





requires 人 OO statistics; 某 些 模块 通过 API 将 另 一 个 模块 的 类 
es 型 公开 ,并 且 没有 另外 那个 模块 就 天 
opens monitor.persistence.entity; 法 工作 ， 所 以 它们 隐 式 表明 可 读 性 
} (参见 15.1.1 节 ) 
不 论 是 Hibernate 还 是 SeMIceMonilor 所 使 用 的 monitor.persistence 将 包含 其 持久 化 实体 的 
Spark 版 本 都 不 是 模块 化 的 ， 所 以 hibernate.jpa 和 包 对 反射 公开 (参见 15.1.2 节 ) 


spark.core 都 是 自动 模块 (参见 15.1.5 节 ) 
module monitor.rest { 


四 Re、 ve 十 -] 某 些 模块 通过 API 将 另 一 个 模块 

exports OO 的 类 型 公开 ， 并 且 没有 另外 那个 模 

) 块 就 无 法 工作 , 所 以 它们 隐 式 表明 
可 读 性 〈 参 见 15.1.1 节 ) 


module monitor { 
requires monitor.observer; 
requires monitor.statistics; 
requires monitor.persistence; 
requires monitor.rest; 
uses monitor.observer.ServiceObserverFactory; 


通过 服务 来 将 消费 者 (monitor) 
和 观察 者 API 的 实现 〈 例 如 
monitorobserveralpha) 进行 解 
看 (参见 15.1.3 节 ) 


} 


不 论 是 Hibernate 还 是 ServiceMonitor 所 使 用 的 Spark 
版 本 都 不 是 模块 化 的 , 所 以 hibernate.jpa 和 spark.core 
都 是 自动 模块 (参见 15.1.5 节 ) 





如 果 将 代码 清单 12-1 与 代码 清单 2-2 进行 对 比 , 或 者 参见 图 15-1, 就 可 以 发 现 , ServiceMonitor 
的 基本 结构 几乎 保持 不 变 。 但 是 仔细 观察 就 能 发 现 一 系列 改进 。 下 面 来 逐一 回顾 。 
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15-1a ”对 使 用 不 同 特性 的 ServiceMonitor 应 月 














程序 的 模块 图 进行 对 比 。 基 础 版 本 仅 























使 用 了 普通 的 exports 和 requires 指令 (a)， 高 级 版 本 则 完整 使 用 了 改 
善 过 的 依赖 、 导 出 以 及 服务 (b )。( 基础 版 本 已 经 被 扩展 为 包含 与 高 级 版 本 








相同 的 模块 和 包 。 ) 


多 亏 了 服务 ，monitor 不 再 
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stats.fancy 









































很 多 regquires 指 令 被 标记 工具 模块 不 再 可 甚至 在 stats.fancy 不 存 ”实体 模块 仅 在 运 
为 了 transitive， 因 为 这 ”被 所 有 模块 访问 在 的 情况 下 ，statistics ” 行 时 可 被 访问 
些 模块 会 在 自己 的 API 中 重 由 可 以 运行 

用 其 他 模块 的 类 型 


























图 15-1b ”对 使 用 不 同 特性 的 ServiceMonitor 应 月 
使 用 了 普通 的 exports 和 requires 





























程序 的 模块 图 进行 对 比 。 基 础 版 本 仅 





指令 (a), 高 级 版 本 则 完整 使 用 了 改善 


过 的 依赖 、 导 出 以 及 服务 (b)。( 基础 版 本 已 经 被 扩展 为 包含 与 高 级 版 本 相同 


的 模块 和 包 。) 
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15.1.1 多 样 化 依赖 


一 个 容易 辨认 的 改变 是 requires transitive 和 requires optional 指令 。 虽 然 在 大 
多 数 情况 下 ， 普 通 requires 指令 是 正确 的 选择 ， 但 是 很 大 一 部 分 依赖 有 些 复杂 。 

最 显著 的 例子 是 可 选 依赖 , 即 某 个 模块 使 用 其 他 模块 中 的 类 型 , 并 因此 需要 基于 后 者 进行 编 
译 , 但 是 该 依赖 模块 在 运行 时 仍 有 可 能 不 存在 。monitor.statistics 和 stats.fancy 正 是 这 种 情况 ， 所 
以 该 依赖 是 通过 requires static 指令 建立 的 。 

接 下 来 , 模块 系统 将 在 编译 monitorstatistics 时 强制 stats.fancy 存在 ( 这 是 合理 的 ,否则 编译 
会 失败 )， 如 果 后 者 进入 模块 图 则 添加 一 条 从 monitor.statistics 到 stats.fancy 的 可 读 边 (这 也 是 合 
理 的 ,否则 monitor.statistics 无 法 访问 stats.fancy 中 的 类 型 ), 但 是 stats.fancy 有 可 能 不 在 模块 图 中 ， 
在 这 种 情况 下 ，monitor statistics 需要 处 理 stats.fancy 不 存在 的 情形 ， 如 代码 清单 15-2 所 示 。 


代码 清单 15-2 ”检查 可 选 依赖 stats.fancy 是 否 存 在 


private static boolean checkFancyStats() { 
boolean isFancyAvailable = isModulePresent ("stats.fancy"); 
String message = "Module 'stats.fancy' is" 
+ (isFancyAvailable ? " " :; " not ") 
+ "available."; 
System.out .println (message); 
return isFancyAvailable; 







































































} 


private static boolean isModulePresent (String moduleName) { 
return Statistician.class 
.getModule() 
.getLayer () 
.findModule (moduleName) 
.isPresent (); 


} 

可 选 依赖 的 讨论 细节 参见 11.2 节 。 

男 一 种 情况 相 较 于 可 选 依赖 则 不 那么 明显 ， 但 一 样 常见 
模块 ， 在 它 的 公有 API 中 有 这 样 一 个 方法 。 


public static MonitorServer create(Supplier<Statistics> statistics) { 
return new MonitorServer(statistics); 





也 许 更 常见 。 例 如 monitorrest 





} 


但 是 statistics 来 自 于 monitorstatistics， 所 以 任何 使 用 rest 的 模块 都 需要 读 取 statistics， 
否则 它 将 无 法 访问 statistics 并 因此 无 法 创建 MonitorServer 实例 。 换 一 个 说 法 ，rest 对 于 
不 读 取 statistics 的 模块 来 说 是 无 用 的 。 在 ServiceMonitor 应 用 程序 中 , 这 种 情况 频繁 得 超 乎 想象 ; 
每 个 模块 ， 如 果 至 少 需要 一 个 其 他 模块 ， 并 且 会 导出 一 个 包 ， 都 是 这 种 情况 。 

这 种 情况 发 生得 如 此 频繁 , 只 是 因为 这 些 模块 都 很 小 , 以 至 于 几乎 所 有 代码 都 是 公有 API 一 一 
如 果 它 们 没有 通过 自身 的 API 持续 导出 依赖 的 类 型 , 那 才 会 很 意外 。 所 以 , 虽然 现实 中 这 种 情况 
相对 少见 ， 但 是 基本 上 每 天 也 都 可 以 见 到 一 一 在 JDK 中 ， 大 概 有 20% 左 右 的 依赖 是 被 公开 的 。 
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证 用 户 猜测 需要 显 式 依赖 哪些 其 他 的 模块 是 一 件 很 麻烦 的 事 ; 








es 





衣 ， 并 且 会 让 模块 声明 变 得 腕 





肿 。 为 了 避免 这 种 情况 ， 模 块 系统 提供 了 reaquires transitive 指令 。 由 于 rest requires 
transitivestatistics， 任 何 读 取 rest 的 模块 也 都 读 取 statistics ， 因 此 rest 的 用 户 避 免 了 对 依赖 的 
猜测 。 隐 式 可 读 性 的 细节 在 11.1 节 中 讨论 过 。 


15.1.2 ”降低 的 可 见 性 


























相对 于 2.2 节 所 展示 的 最 初版 本 , 该 应 用 程序 的 另 一 个 变化 是 , 其 模块 尽量 减少 API 的 范围 。 





更 新 后 的 模块 明显 减少 普通 xports 
口 多 亏 了 服务 ， 观 察 者 不 再 需要 将 
口 通过 合 规 导出 ，monitor.observer 
的 模块 访问 。 

口 monitor.persistence 将 实体 包公 开 





























指令 的 使 用 。 
它们 的 实现 导出 。 
中 的 monitor.observer.utils 包 只 可 以 被 香干 指定 


， 而 非 导 出 ， 使 得 它 仅 在 运行 时 可 用 。 








这 些 变化 减少 了 容易 被 其 他 随机 的 模块 访问 的 代码 量 , 意味 着 开发 者 可 以 在 模块 内 部 改变 更 








多 的 代码 ， 而 无 须 担 心 对 下 游 用 户 产 生 影响 。 通 过 这 种 方式 减 小 API 的 范围 , 对 于 框架 和 类 库 的 




















可 维护 性 来 说 是 个 极 大 的 恩惠 ， 同 时 包含 大 量 模块 的 大 型 应 用 程序 也 能 从 中 受益 。11.3 节 介 绍 过 


合 规 导 出 ，12.2 节 探 寻 过 开放 式 包 。 


15.1.3 ”通过 服务 解 耦 





与 2.2 节 相 比 , 模块 图 唯一 的 结构 性 改变 在 于 monitor 不 再 直接 依赖 于 观察 者 的 实现 。 相 反 ， 


它 仅 依赖 于 提供 API 的 模块 一 一 monitor. 





observer,) 租 将 ServiceObserverFactory 用 作 服 务 。 











3 个 实现 模块 都 用 它们 自己 的 实现 来 提供 此 项 服务 ， 并 且 模 块 系统 将 两 边 连 接 了 起 来 。 
这 不 仅仅 是 审美 上 的 提高 。 多亏 了 服务 , 我 们 才 有 可 能 在 启动 时 配置 应 用 程序 的 行为 ， 即 它 
可 以 观察 哪些 类 型 的 服务 。 通 过 增加 或 删除 提供 服务 的 模块 ,可 以 增加 新 的 实现 , 或 者 删除 过 期 

















的 实现 
请 查阅 第 10 章 来 了 解 服务 的 相关 内 容 。 














不 需要 对 monitor 进行 任何 改动 ， 因 此 可 以 继续 使 用 相同 的 工件 而 不 需要 重新 构建 。 





15.1.4 在 运行 时 通过 层 来 加 载 代码 








虽然 服务 允许 我 们 在 启动 时 定义 应 用 程序 的 行为 , 但 现在 我 们 甚至 可 以 走 得 更 远 。 虽 然 在 模 


块 声明 中 不 可 见 , 但 是 通过 让 monitor 





模块 创建 新 的 层 ， 我 们 使 应 用 程序 在 启动 时 其 至 没有 








ServiceObserver 实现 的 情况 下 也 可 以 在 运行 时 观察 服务 。 按 照 需求 ，monitor 将 创建 一 个 新 








的 模块 图 以 及 类 加 载 器 ， 并 加 载 额外 的 类 ， 进 而 更 新 它 的 观察 者 列表 ， 如 代码 清单 15-3 所 示 。 
代码 清单 15-3 ”基于 为 这 些 路 径 上 的 模块 创建 的 模块 图 来 创建 一 个 新 的 层 


private static ModuleLayer createLayer (Path[] modulePaths) { 








Configuration configuration 





= createConfiguration (modulePaths); 


ClassLoader thisLoader = getThisLoader(); 
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return getThisLayer() 
.defineModulesWithOneLoader (configuration, thisLoader); 


} 


private static Configuration createConfiguration(Path[] modulePaths) { 
return getThisLayer() 
.configuration() 
.resolveAndBind( 
ModuleFinder.of(), 
ModuleFinder.of (modulePaths), 
Collections.emptyList() 
); 
} 
这 样 的 行为 对 于 不 经 常 重新 部 署 且 不 容易 重新 启动 的 应 用 程序 来 说 尤为 有 趣 。 这 让 我 想起 了 
复杂 桌面 应 用 程序 ， 但 是 对 于 运行 在 客户 数据 中 心 且 需要 高 可 配置 性 的 Web 后 端 服务 来 说 也 是 
一 样 的。 请 参考 12.4 节 来 了 解 层 的 定义 以 及 如 何 创 建 层 。 


15.1.5 ”处 理 对 普通 JAR 的 依赖 


男 一 个 模块 声明 中 不 太 显 见 的 细节 是 ServiceMonitor 中 第 三 方 依赖 的 模块 化 程度 。 它 所 使 用 
的 Hibernate 和 Spark 的 版 本 都 尚未 模块 化 ， 仍 然 以 普通 JAR 发 布 。 因 为 清晰 模块 需要 它们 ， 所 
以 其 必须 被 放置 在 模块 路 径 中 ， 进 而 被 模块 系统 转变 为 自动 模块 。 

所 以 ， 虽 然 ServiceMonitor 已 被 完全 模块 化 ， 但 是 它 仍然 依赖 于 尚未 模块 化 的 JAR。 从 整个 
生态 系统 的 视角 来 看 待 此 问题 ,JDK 模块 在 最 底层 ， 而 应 用 程序 模块 在 最 顶层, 这 是 一 个 有 效 的 
自 顶 向 下 的 模块 化 进程 。 

8.3 节 介绍 过 自动 模块 ， 而 且 整 个 第 8 章 也 都 适用 于 此 。 如 果 想 了 解 更 多 的 模块 化 策略 ， 请 
参阅 9.2 节 。 
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本 书 用 大 量 篇 幅 介 绍 了 如 何 使 用 模块 系统 的 各 种 工具 来 解决 不 同 的 问题 。 这 对 一 本 关于 
JPMS 的 图 书 来 说 , 无 疑 是 很 重要 的 , 但 是 在 你 读 完 本 书 之 前 ,让 我 们 整体 回顾 一 下 工具 箱 清单 。 

首要 问题 是 , 你 是 否 想 使 用 这 些 工具 ?在 没有 提示 的 情况 下 , 你 是 否 想 创建 模块 ( 参见 15.2.1 
节 ) ?一旦 答案 确定 了 ， 我 们 将 尝试 对 理想 的 模块 进行 定义 ( 参见 15.2.2 节 )。 接 下 来 会 聚焦 于 
如 何 让 模块 声明 保持 一 流 的 形态 ( 参见 15.2.3 节 )， 以 及 哪些 改动 可 能 会 破坏 用 户 的 代码 ( 参见 
15.2.4 区 。 


15.2.1 是 否 模 块 化 


至 此 , 你 已 经 学 习 了 模块 系统 的 所 有 内 容 一 一 它 的 特性 、 缺 陷 、 承 诺 以 及 限制 一 一 也 许 你 还 
在 问 自己 ,是 否 需 要 将 你 的 JAR 模块 化 。 最 终 ， 只 有 你 和 你 的 团队 可 以 针对 你 的 项 目 来 回答 这 
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个 问题 ,但 是 我 可 以 提供 一 些 对 这 个 问题 的 思考 。 

就 像 本 书 中 所 表达 的 那样 ,我 认为 模块 系统 提供 了 很 多 好 处 ,它们 对 类 库 、 框 架 以 及 大 多 数 
具有 一 定 规模 的 应 用 程序 来 说 很 重要 。 尤 其 是 强 封装 、 通 过 服务 解 耦 ( 虽然 不 需要 模块 也 能 实现 ， 
即使 并 不 是 很 方便 ) 以 及 应 用 程序 镜像 都 能 很 好 地 支持 我 的 观点 。 

但 我 最 欣赏 的 是 模块 声明 本 身 : 在 任何 时 候 , 它们 都 是 你 的 项 目 架构 的 真实 反映 ， 并且 会 对 
每 个 工作 于 系统 中 相关 方面 的 开发 者 和 架构 师 带 来 大 量 好 处 ， 以 至 于 可 以 提高 整体 的 可 维护 性 
(15.2.3 节 将 进行 更 深入 的 讨论 )。 


要 点 ”基于 这 些 原因 ， 在 开始 每 一 个 针对 Java9 及 以 上 版 本 的 项 目 时 ， 我 默认 会 
采用 模块 ( 理论 上 来 说 ， 一 些 项 目 相关 的 原因 会 使 我 有 另外 的 想法 ， 但 没有 足够 
的 力量 使 我 改变 策略 )。 如 果 放 置 到 模块 路 径 时 依赖 开始 制造 过 多 的 问题 ( 例如 ， 
它们 可 能 会 导致 包 分 裂 一 一 参见 7.2 节 ), 那么 很 容易 用 类 路 径 来 蔡 换 模 块 路 径 以 
放弃 模块 系统 。 如 果 一 开始 你 就 使 用 模块 系统 ， 对 它们 的 创建 和 更 新 几乎 不 消耗 
任何 额外 的 时 间 ， 那 么 相对 而 言 ， 改 善 过 的 可 维护 性 将 极 大 地 减少 随 着 项 目 规模 
增长 而 不 得 不 做 的 整理 。 


如 果 你 还 没 被 说 服 ， 那 就 先 尝 试 一 下 。 用 模块 构建 一 个 演示 项 目 ， 或 是 最 好 构建 
一 个 拥有 真实 用 户 和 需求 的 小 型 应 用 程序 。 非 关键 的 、 公 司 内 部 的 工具 是 非常 合 
适 的 实验 对 象 。 


当 来 到 模块 化 已 有 项 目 时 ， 答 案 更 倾向 于 “ 视 情 况 而 定 "。 需 要 的 工作 量 显而易见 ， 但 是 好 
也 触 手 可 得 。 事 实 上 ， 越 是 有 更 多 的 工作 需要 做 ， 通 常 越 是 会 有 更 多 的 回报 。 想 象 一 下 : 哪些 
用 程序 最 难 模块 化 ”就 是 那些 包含 更 多 工件 、 乱 成 一 团 以 及 不 易 维护 的 应 用 程序 。 但 是 这 些 也 
是 能 够 从 中 得 到 更 多 好 处 的 应 用 程序 。 所 以 ,， 当 有 人 认为 将 某 个 现 有 项 目 模块 化 的 成 本 很 低 而 
好 处 很 多 ( 或 者 相反 )， 则 需要 当心 了 。 


要 点 ”在 最 后 ,一 个 项 目的 预期 生命 时 长 可 以 作为 决策 的 关键 。 项 目 需 要 被 维护 
的 时 间 越 长 ， 模 块 化 的 相对 代价 就 越 低 ， 好 处 就 越 大 。 挽 句 话 说 ， 剩 余 “ 寿 命 ” 
越 长 ， 模 块 化 的 意义 越 大。 

如 果 你 正在 工作 的 项 目 〈 比如 类 库 或 者 框架 ) 中 有 一 些 用 户 不 属于 你 的 团队 , 你 也 需要 将 他 
们 的 需求 考虑 进去 。 即 便 模块 化 对 你 来 说 不 是 那么 值得 , 这 些 团 队 外 的 用 户 也 可 以 从 中 获得 大 量 
好 处 。 


15.2.2 ”理想 的 模块 

假设 你 已 经 做 了 决定 并 开始 使 用 模块 ,理想 的 模块 什么 样子 ?分割 模 块 和 撰写 模块 定义 是 为 
了 达到 什么 样 的 效果 ?这 个 问题 依旧 没有 标准 答案 ,但 是 一 系列 信号 值得 你 注意 : 

口 模块 尺寸 
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口 API 范 围 
口 模块 间 的 耦合 

在 依次 讨论 每 个 标志 信和 号 之 前 ,我 想 补充 一 点 ， 即 使 你 对 理想 的 模块 有 一 定 概念 ,也 不 太 可 
能 保证 所 创建 的 每 个 模块 都 是 完美 的 。 特 别 是 如 果 从 模块 化 现 有 项 目 开 始 ， 那 么 在 这 个 过 程 中 ， 
你 可 能 会 创建 一 些 较为 丑陋 的 模块 。 

如 果 你 正在 开发 应 用 程序 ， 则 不 必 担 心 一 一 你 可 以 在 进行 过 程 中 轻松 地 重 构 模块 。 对 于 类 库 
和 框架 开发 人 员 而 言 ， 难 度 会 更 大 一 些 。 正 如 我 们 将 在 15.2.4 节 中 看 到 的 , 许多 重 构 步骤 会 破坏 
用 户 代码 ， 导 致 其 开发 自由 度 大 大 降低 。 

现在 ,我 们 通过 可 以 观察 到 的 3 个 信号 来 判断 模块 的 质量 : 大 小 、 接 口 和 耦合 度 。 


1. 保持 模块 足够 小 〈 越 小 越 好 ) 

模块 声明 为 你 提供 了 一 个 很 好 的 工具 来 分 析 和 雕刻 模块 之 间 的 边界 , 但 它们 对 模块 内 部 发 生 
的 事情 相对 并 不 了 解 。 包 之 间 存 在 循环 依赖 吗 ? 所 有 的 类 和 成 员 都 是 公有 的 吗 ? 这 是 一 个 “大 泥 
球 ” 吗 ?这 些 可 能 会 影响 开发 过 程 ， 但 模块 声明 并 不 会 将 它们 反映 出 来 。 

这 意味 着 你 拥有 的 模块 声明 越 多 ， 对 代码 结构 的 了 解 和 控制 就 越 多 ( 如 图 15-2 所 示 )。 男 一 
方面 , 模块 、JAR 以 及 (通常 情况 下 的 ) 构建 工具 项 目 之 间 存 在 一 一 对 应 的 关系 ， 因 此 更 多 的 模 
块 声明 也 意味 着 会 增加 维护 工作 和 消耗 更 长 的 构建 时 间 。 显 然 这 是 一 个 需要 权衡 的 决策 。 


忽略 包 之 后 ， 模 块 之 间 的 关系 


看 起 来 不 错 
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包 之 间 的 关系 是 混乱 的 一 一 
两 种 情况 下 都 是 















































额外 的 模块 边界 让 混乱 循环 模块 依赖 

的 关系 变 得 清晰 是 不 可 能 的 

图 15-2 图 中 这 些 包 之 间 的 关系 可 以 说 有 些 混 乱 。 尽 管 只 有 两 个 模块 (上 )， 但 关系 并 
不 明显 。 只 有 在 尝试 创建 更 多 模块 (下 ) 时 ， 问 题 才 变 得 清晰 起 来 。 附 加 的 
模块 边界 提供 了 这 种 深入 分 析 的 手段 
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总 体 而 言 ， 还 是 选择 较 小 的 模块 而 不 是 较 大 的 。 一 旦 模块 的 代码 行 达到 5 位 数 ， 你 就 可 全 
要 考虑 将 其 拆 分 。 当 模块 代码 跨 入 6 位 数 时 ,建议 你 认真 考虑 一 下 。 如 果 是 7 位 数 ， 那 么 你 可 
需要 先进 行 一 些 认 真 的 重 构 工作 ( 如 果 你 无 法 打破 类 之 间 的 循环 依赖 关系 ,请 参阅 10.3.5 节 ， 通 
过 使 用 服务 来 做 到 这 一 点 )。 


要 点 。 话 虽 这 么 说 , 但 不 要 相信 在 没有 查看 你 项 目的 情况 下 就 告诉 你 合适 的 模块 
大 小 的 任何 人 。“ 模 块 应 该 多 大 ? ”这 个 问题 唯一 有 意义 的 答案 是 “看 具体 情况 ”。 
每 个 模块 都 应 该 是 针对 特定 问题 的 高 内 聚 解决 方案 。 如 果 该 问题 碰巧 有 一 个 很 大 
的 解决 方案 ， 那 没关系 不 要 将 原本 属于 同一 部 分 的 东西 分 开 。 


属于 同一 部 分 的 东西 是 什么 ” 当 一 个 高 内 聚 的 模块 被 切 成 两 部 分 时 , 必然 会 在 两 部 分 之 间 存 
在 一 个 相当 大 的 API 接 口 面 一 一 这 就 是 接 下 来 需要 讨论 的 主题 。 


2. 保持 API 接口 面 足够 小 


和 个 要 点 “模块 的 优势 在 于 它们 可 以 自行 控制 内 部 信息 。 这 使 得 模块 内 的 重 构 更 加 容 
入) 易 ， 并 且 其 公有 API 的 设计 和 演化 更 加 谨慎 。 考 虑 到 这 些 好 处 ， 较 少数 量 的 
exports 基本 指令 通常 是 最 佳 选择 。 合 规 导 出 也 是 如 此 越 少 越 好 。 


常规 导出 和 合 规 导 出 有 何 区 别 ? 在 一 个 项 目 内 部 ,二 者 没有 太 大 的 区 别 。 当 涉及 两 个 模块 时 ， 
是 否 为 合 规 导 出 并 不 重要 。 这 也 就 是 说 ， 合 规 条 件 至 少 表 明 该 API 可 能 不 是 为 通用 用 例 所 设计 
的 ， 这 是 有 价值 的 信息 ， 尤 其 是 在 较 大 的 项 目 中 。 

与 应 用 程序 不 同 , 类 库 和 框架 必须 始终 考虑 其 导出 如 何 影响 依赖 于 它们 的 项 目 。 在 这 种 情况 
下 , 仅 在 同一 项 目 内 合 规 导 出 到 其 他 模块 , 就 好 像 此 包 完 全 没 被 导出 一 样 , 这 绝对 是 双语 的 选择 。 
总 而 言 之 , 合 规 导出 对 API 接 口 面 仍 上 日 有 贡献 : 在 一 个 项 目 内 部 , 其 和 常规 导出 的 贡献 程度 相当 ， 
跨 项 目 边界 时 则 少 很 多 。 


3. 保持 耦合 度 足 够 低 

随机 选择 两 段 代码 一 一 无 论 是 方法 、 类 还 是 模块 都 没关系 ,在 其 他 所 有 条 件 都 相同 的 情况 下 ， 
依赖 关系 较 少 的 代码 更 易于 维护 。 原 因 很 简单 : 依赖 越 多 ， 容 易 产 生 破坏 的 更 改 就 越 多 。 

但 是 ,其 实 不 仅 是 简单 的 依赖 关系 : 更 普遍 的 是 耦合 度 的 问题 。 如 果 一 个 模块 不 仅 依赖 于 另 
一 个 模块 ,而且 广泛 地 使 用 其 全 部 十 几 个 的 导出 包 , 则 可 以 说 这 两 个 模块 是 紧密 耦合 的 。 如 果 其 
中 还 混合 了 合 规 导 出 ， 那 么 耦合 度 就 更 高 ， 因 为 从 合 规 导 出 的 概念 上 看 :“ 虽 然 这 不 是 受 支持 的 
API, 但 是 让 你 使 用 也 无 妨 。” 


要 点 ”这 不 仅 限 于 单个 模块 。 要 了 解 一 个 系统 ， 你 不 仅 需 要 了 解 各 个 部 件 ( 此 处 
指 模块 )， 还 需要 了 解 其 中 的 诸多 连接 ( 此 处 指 依赖 关系 和 耦合 度 ) 而 且 ， 如 果 
你 不 认真 ,系统 的 连接 数 可 能 比 各 部 件 总 数 还 多 ( 大 约 是 模块 数 的 平方 , 杂 15-3 
所 示 )。 因 此 ， 部 件 间 的 松散 耦 合 是 保持 系统 尽 可 能 简单 的 关键 因素 。 
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右 侧 更 为 复杂 不 是 因为 有 更 多 的 元 素 ， 
而 是 因为 有 更 多 的 连接 


本 


Ey 全 


15-3 即使 图 中 左右 两 侧 的 节点 数量 相同 ， 它 们 的 复杂 度 差异 可 能 也 很 大 。 左 侧 大 
概 每 个 节点 各 有 一 条 边 ， 而 右 侧 每 个 节点 至 少 有 一 对 边 。 如 果 新 增 一 个 节点 ， 
则 左 侧 将 新 增 1~2 条 新 边 ， 而 右 侧 将 大 约 新 增 6 条 边 


模块 解 看 的 一 种 好 方法 是 第 10 章 所 讲 的 服务 。 服 务 不 仅 打破 了 模块 之 间 的 直接 依赖 关系 ， 
而 且 还 要 求 你 拥有 一 种 可 以 访问 整个 API 的 单一 类 型 。 除 非 你 将 该 类 型 转换 为 可 连接 到 其 他 数 十 
种 类 型 的 奇怪 混合 物 ， 和 否则 这 将 大 大 减少 模块 之 间 的 耦合 度 。 


要 点 ”一 个 警告 : 服务 是 优雅 的 ， 但 它们 比 常 规 的 依赖 更 难以 预测 。 你 不 容易 发 
现 两 段 代 码 是 如 何 连接 的 ， 并 且 当 缺少 提供 者 时 你 也 不 会 得 到 错误 信息 。 因 此 ， 
不 要 急于 在 任何 地 方 使 用 服务 。 
以 下 是 一 个 决定 性 检验 :你 是 否 可 以 使 用 合理 但 足够 小 的 API 来 创建 服务 类 型 ? 在 模块 图 上 
它 的 每 条 边 是 否 被 不 止 一 个 模块 使 用 或 者 提供 ? 
如 果 不 确定 ， 请 参看 JDK。 官 方 文档 列 出 了 模块 使 用 或 提供 的 服务 ， 并 且 你 可 以 使 用 IDE 
查看 用 户 代 码 和 实现 代码 。 


4. 遵照 模块 声明 













































































要 点 ”前面 刚刚 讨论 过 ， 模 块 应 该 很 小 ， 而 API 接口 面 应 该 更 小 ， 并 且 应 该 与 周 
围 环 境 松散 耦合 。 最 后 ， 这 些 建 议 可 以 归结 为 一 个 看 似 简单 的 公式 : 高 内 聚 、 低 
耦合 。 通 过 寻找 合适 的 模块 大 小 、exports 的 数量 、requires 的 数量 以 及 各 依 
赖 的 强度 ， 可 以 帮助 你 实现 最 终 目标 。 





注意 像 任何 一 组 目标 数字 一 样 ， 上 述 3 个 目标 可 能 一 无 所 获 。 经 过 深思 熟 虑 的 整体 架 
构 比 几 个 数字 更 为 重要 。 尽 管 本 书 为 你 提供 了 很 多 工具 ,其 至 提供 了 一 些 实现 这 些 目标 
的 技巧 ， 但 它 并 非 一 个 从 零 开 始 的 解决 方案 。 


另 请 注意 ， 这 3 个 标志 信号 ( 大小、 接口 面 和 内 聚 力 ) 通常 会 相互 影响 。 作 为 一 个 极端 的 例 
子 ， 以 仅 包 含 一 个 模块 的 应 用 程序 为 例 。 它 很 可 能 没有 API， 而 且 只 有 一 个 工件 ， 耦 合 度 很 低 。 
另 一 个 极端 是 一 个 代码 库 的 每 个 模块 中 的 每 个 包 都 依赖 许多 具有 小 API 接 口 面 的 小 模块 。 这 些 极 
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端 情况 固然 可 笑 ， 但 它们 说 明了 问题 所 在 : 这 是 一 种 平衡 的 艺术 。 


要 点 ”总 之 , 这 些 标志 信号 只 是 标志 信号 而 已 一 一 你 和 你 的 团队 将 始终 必须 根据 
其 提供 的 信息 做 出 自己 的 正确 判断 。 但 是 你 的 模块 声明 可 以 帮助 你 实现 这 些 目 
标 。 如 果 它 们 变 得 非常 复杂 并 且 经 常 需 要 大 量 更 改 ， 那 么 这 是 已 经 尝试 在 警告 你 
了 。 请 听从 它们 。 





15.2.3 ”注意 模块 声明 


如 果 你 正在 构建 模块 化 项 目 , 那么 模块 声明 很 容易 成 为 代码 类 库 中 最 重要 的 .java 文件。 它们 
中 的 每 一 个 都 代表 一 个 完整 的 JAR， 总共 可 能 包含 数 十 个 、 数 百 个 甚至 数 干 个 这 样 的 文件 。 模块 
化 声明 不 仅仅 代表 这 些 ， 其 还 控制 着 模块 之 间 的 交互 方式 。 

因此 ， 你 应 该 非常 注意 模块 声明 ! 以 下 有 一 些 注意 事项 : 

口 保持 声明 整洁 
口 注释 声明 
口 检查 声明 
下 面 来 一 一 讲解 。 


1. 干净 整洁 的 模块 声明 

模块 声明 是 代码 ， 应 该 按照 代码 的 要 求 来 规范 它 ， 并 且 确 保 应 用 代码 的 风格 。 一 致 的 缩 进 、 
行 长 、 括 号 位 置 等 一 一 这 些 规则 对 于 声明 ， 就 像 对 于 其 他 任何 源 代 码 文件 一 样 富有 意义 。 

另外 , 强烈 建议 按 结 构 编 写 模块 声明 ， 而 不 要 按 随 机 顺序 放置 不 同 的 指令 。JDK 和 本 书 中 的 
所 有 声明 都 遵循 以 下 顺序 。 


(1) requires, 包括 static 和 transitive 





























(2) exports 

(3) exports to 

(4) opens 

($5) opens to 

(6) uses 

(7) provides 

JDK 总 是 在 不 同 指令 块 之 间 放 一 个 空 行 以 将 它们 分 开 一 一 我 仅 在 有 和 较 多 指令 的 情况 下 才 这 
样 做 。 

更 进一步 , 你 可 以 定义 在 同一 块 中 如 何 对 各 个 指令 进行 排序 。 按 首 字母 排序 是 一 个 显而易见 
的 选择 ， 尽 管 对 于 *eauires ， 我 通常 会 首先 列 出 内 部 依赖 ， 再 列 出 外 部 依赖 。 


注意 ”无论 如 何 决定 , 如 果 你 通过 一 个 文档 来 记录 代码 风格 ,那么 请 记录 清楚 这 些 决 定 。 
如 果 你 通过 IDE、 构 建 工具 或 代码 分 析 器 来 帮助 你 检查 ， 那 就 更 好 了 。 尝 试 使 用 它们 ， 
通过 自动 检查 和 应 用 代码 风格 ， 使 你 的 工作 更 具 效 率 。 
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2. 丰富 注释 的 模块 声明 

关于 代码 文档 〈 比如 Javadoc 或 行内 注释 ) 的 意见 ， 内 容 千 差 万 别 ， 但 是 这 并 不 是 说 明 其 重 
要 性 的 关键 。 无 论 你 的 团队 对 注释 的 立场 是 什么 ， 都 建议 将 它们 的 使 用 延伸 至 模块 声明 。 

如 果 你 喜欢 为 每 个 抽象 都 注释 一 个 句子 或 一 小 段 内 容 以 说 明 其 含义 和 重要 性 ， 那 么 请 考虑 
向 每 个 模块 都 添加 Javadoc 注释 。 

和 


2 











module monitor.statistics { 
ee 

小 

JDK 在 每 个 模块 上 都 有 这 样 甚至 更 长 的 注释 。 

即使 你 不 喜欢 写 下 该 模块 是 做 什么 的 , 大 多 数 人 同意 应 该 写 明 为 什么 某 个 决定 具有 价值 。 在 
模块 声明 中 ， 可 以 添加 一 个 行内 注释 : 
口 对 于 可 选 依赖 ， 解 释 为 什么 该 模块 可 以 不 存在 ; 
口 对 于 合 规 导 出 ， 解 释 为 什么 它 不 是 公有 API， 但 仍 可 被 特定 模块 访问 ; 
口 对 于 开放 式 包 ， 解释 计 划 允 许 被 哪些 框架 访问 。 

在 JDK 中 ， 你 有 时 会 在 jdk.naming.rmi 中 找到 类 似 这 样 的 注释 : 

// 临时 导出 ， 直 到 NamingManager.getURLContext 使 用 服务 

exports com.sun.jndi.url.rmi to java.naming; 

通常 而 言 , 我 的 建议 是 : 每 次 做 出 没 那么 直观 的 决定 时 都 要 添加 注释 。 每 当 检查 人 询问 为 什 
么 要 进行 某 些 更 改 时 ,请 添加 注释 。 这 样 做 可 以 为 你 的 同事 一 一 或 者 两 个 月 后 的 你 自己 提供 帮助 。 


村 人 要 点 ”模块 声明 提供 了 新 的 契机 : 在 代码 中 正确 记录 项 目 工件 之 间 的 关系 从 未 如 


3. 充分 检查 的 模块 声明 

模块 声明 是 模块 化 结构 的 中 心 表述 , 不 论 你 进行 何 种 代码 审查 , 都 应 该 将 模块 声明 的 检查 作 
为 其 组 成 部 分 。 无 论 对 代码 改动 的 检查 是 发 生 在 提交 代码 之 前 , 或 是 在 打开 拉 取 请 求 之 前 ， 又 或 
是 在 结对 编程 完成 时 ， 再 或 是 在 正式 的 代码 审查 期 间 ， 都 应 该 对 module-info.java 给 予 特别 
的 注意 。 
口 添加 的 依赖 是 否 确实 有 必要 ? 它们 与 项 目的 基础 架构 是 否 一 致 ? 它们 是 否 由 于 模块 的 
API 使 用 了 它们 的 类 型 而 被 通过 requires transitive 指令 导出 ? 
口 如 果 依 赖 是 可 选 的 ， 那 么 代码 是 否 已 经 准备 好 在 运行 时 处 理 依 赖 缺 失 的 情况 ?是 否 有 连 
带 效应 ， 比 如 缺少 可 选 依赖 中 隐 式 依赖 的 传递 依赖 ? 
口 是 否 可 以 将 新 的 依赖 蔡 换 为 服务 ? 
口 增加 的 导出 是 否 确实 有 必要 ? 是 否 新 导出 包 中 的 全 部 公有 类 都 已 经 做 好 公有 的 使 用 准 

备 ， 或 者 是 否 需要 重 构 它们 以 减少 API 接 口 面 ? 
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口 如 果 导 出 是 合 规 的 ， 这 确实 有 意义 吗 ? 或 者 仅仅 是 为 了 访问 那些 从 来 不 应 该 公有 的 API 
的 结果 ? 

口 是 否 已 经 将 用 作 服 务 的 类 型 设计 为 应 用 程序 基础 架构 的 组 成 部 分 ? 

口 是 否 进 行 了 某 些 变更 ， 可 能 会 对 不 属于 构建 过 程 的 下 游 使 用 者 产生 负面 影响 〈 更 多 信息 
请 参见 15.2.4 节 ) ? 

口 是否 根据 团队 要 求 应 用 了 模块 声明 的 代码 风格 和 注释 ? 

勤奋 的 检查 尤为 重要 , 因为 IDE 通常 提供 了 快速 修复 程序 , 使 开发 人 员 可 以 通过 导出 包 或 使 
用 简单 命令 添加 依赖 来 远程 编辑 声明 。 我 很 欣赏 这 些 功 能 , 但 是 它们 增加 了 粗心 大 意 编辑 的 可 能 
性 。 因 此 ， 更 重要 的 是 要 确保 每 次 改动 都 被 注意 到 。 


注意 ”如 果 你 有 代码 审查 指南 、 代 码 提 交 检 查 清单 或 其 他 任何 有 助 于 保持 较 高 代码 质量 
的 文档 ， 那 么 请 在 其 中 添加 有 关 模 块 声明 的 条 目 。 


花 时 间 审 查 模块 描述 符 可 能 听 起 来 需要 很 多 额外 的 工作 。 首 先 ,我 将 讨论 是 否 会 有 很 多 , 尤 
其 是 与 开发 和 审查 代码 库 的 其 余部 分 所 付出 的 努力 相 比 。 不 过 ,更 重要 的 是 ,我 不 认为 这 是 一 项 
额外 的 任务 一 一 而 是 将 其 视 为 一 个 机 会 。 
要 点 ”分 析 和 审查 项 目的 架构 从 来 没有 像 现 在 这 样 容易 。 也 不 是 像 几 年 前 一 样 ， 
将 白板 上 的 架构 草图 拍摄 下 来 ,上 传 到 团队 的 wiki 上 ,现在 讨论 的 是 真正 的 事情 ， 
即 工件 之 间 的 实际 关系 。 模 块 声明 向 你 展示 了 赤裸 裸 的 现实 , 而 不 是 过 时 的 期 许 。 































































































15.2.4 ”更改 模块 声明 可 能 破坏 代码 


与 其 他 任何 源 文件 一 样 , 更 改 模块 声明 可 能 会 对 其 他 代码 产生 意料 之 外 的 破坏 效果 。 但 是 更 
严重 的 是 ， 模 块 声明 是 模块 公有 API 的 提炼 ， 因 此 其 影响 比 任何 随机 类 都 要 高 得 多 。 

如 果 开 发 应 用 程序 时 模块 的 所 有 使 用 者 都 在 同一 构建 过 程 中 , 那么 突然 的 变更 就 不 容易 被 忽 
视 。 即 使 对 于 框架 和 类 库 ， 也 可 以 通过 全 面 的 集成 测试 以 及 时 发 现 此 类 变更 。 



































要 点 “尽管 如 此 ， 了 解 哪些 变更 较 可 能 引起 问题 以 及 哪些 通常 是 无 害 的 ， 还 是 很 
有 帮助 的 。 以 下 是 变更 麻烦 程度 排行 榜 。 


(1) 新 模块 名 称 。 

(2) 导出 包 太 少 。 

(3) 服务 变更 。 

(4) 更 改 依 赖 。 

如 你 所 见 ， 所 有 这 些 变更 都 可 能 在 下 游 项 目 中 导致 编译 错误 或 意外 的 运行 时 行为 。 
因此 ， 应 该 始终 将 它们 视 为 重大 变更 。 并 且 ， 如 果 你 使 用 语义 版 本 号 〈 Semantic 
versioning )， 那 么 应 因此 产生 一 个 主 版 本 。 这 并 不 意味 着 在 模块 声明 中 进行 其 他 变更 
就 不 会 引起 问题 ， 只 是 它们 的 可 能 性 要 小 得 多 。 因 此 ， 让 我 们 着 重 讨论 这 4 个 方面 。 
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1. 新 模块 名 称 的 影响 

变更 模块 名 称 将 立即 破坏 所 有 依赖 该 模块 的 其 他 模块 一 一 这 些 模块 将 不 得 不 进行 更 新 和 重 
新 构建 。 尽 管 这 是 它 可 能 引起 的 最 小 问题 。 

更 大 的 危险 是 ,这 可 能 导致 模块 化 的 死亡 之 眼 (参见 3.2.2 节 )， 某 个 项 目 可 能 会 间接 地 依赖 
你 的 模块 两 次 : 一 次 是 旧名 称 ， 一 次 是 新 名 称 。 那 么 该 项 目 在 尝试 引用 你 的 模块 的 新 版 本 时 ,将 
经 历 一 段 艰难 的 过 程 ， 或 者 可 能 由 于 名 称 的 变更 而 不 得 不 避 开 模块 的 更 新 。 

请 意识 到 这 一 点 ,并 尝试 将 重 命名 的 影响 降 到 最 小 。 你 可 能 仍然 偶尔 需要 这 样 做 , 那么 请 尝 
试 通过 使 用 日 名称 创建 聚合 器 模块 来 减轻 这 种 影响 〈 参 见 11.1.5 区 。 


2. 导出 包 太 少 的 影响 

为 什么 导出 包 “ 太 少 ”会 出 现 问题 ? 答案 很 明显 : 使 用 这 些 包 中 类 型 的 任何 模块 在 编译 时 和 
运行 时 都 无 法 访问 它们 。 如 果 一 定 要 这 么 做 , 那么 必须 先 废弃 这 些 包 和 类 型 ， 以 使 你 的 用 户 在 它 
们 被 删除 之 前 有 机 会 进行 修改 。 
这 完全 仅 适 用 于 普通 的 exports 指令 。 
口 合 规 导 出 通常 仅 导 出 到 你 控制 的 其 他 模块 ， 并 且 很 可 能 是 构建 的 一 部 分 ， 因 此 可 以 同时 
进行 更 新 。 
口 开放 式 包 通常 针对 特定 的 框架 或 旨 在 反射 它们 的 代码 段 。 这 些 代 码 很 少 会 是 用 户 模 块 的 

一 部 分 ， 因 此 关闭 这 些 包 不 会 对 其 产生 影响 。 

一 般 来 说 , 我 不 会 把 取消 合 规 导出 或 开放 式 包 视 为 重大 变更 。 但 是 , 特定 的 场景 可 能 不 同 于 
这 条 经 验 法 则 ， 因 此 在 进行 此 类 变更 时 ， 请 小 心 并 且 仔 细 考虑 。 


3. 添加 或 删除 服务 的 影响 

有 了 服务 ， 情 况 就 不 那么 清楚 了 。 如 10.3.1 节 所 述 ， 服 务 使 用 者 应 始终 准备 好 应 对 服务 提供 
者 缺失 的 情况 。 同 样 ， 当 罕 然 返回 一 个 额外 的 提供 者 时 ， 它 们 也 不 应 该 中 断 。 但 这 仅 涵盖 了 一 种 
情况 一 一 应 用 程序 不 应 该 由 于 服务 加 载 器 返回 了 错误 数量 的 提供 者 而 骨 省 。 

仍然 可 以 想象 ， 甚至 有 可 能 ， 当 某 个 服务 存在 于 一 个 版 本 中 而 不 在 另 一 个 版 本 中 时 , 应 用 程 
序 的 行为 会 发 生 异 常 。 并 且 由 于 服务 绑 定 发 生 在 所 有 模块 上 , 因此 甚至 可 能 会 影响 不 直接 依赖 这 
些 服 务 的 代码 。 


4. 更 改 依赖 的 影响 

列表 上 的 最 后 一 点 , 即 所 有 形式 的 依赖 , 也 是 一 个 灰色 区 域 。 让 我 们 从 requires transitive 
开始 。11.1.4 节 曾 解释 说 ， 如 果 用 户 在 模块 附近 直接 使 用 它 ， 则 只 应 依赖 于 你 让 它们 读 取 的 依 
赖 。 假 设 你 停止 公开 依赖 的 类 型 ， 并 且 用 户 也 更 新 了 他 们 的 代码 ， 那 么 从 exports 指令 中 删除 
transitive 应 该 不 会 影响 他 们 。 

另 一 方面 ,他 们 可 能 不 了 解 或 没 注意 该 建议 ,所 以 为 防止 他 们 读 取 依赖 ， 仍 然 需要 他 们 进行 
更 新 和 重建 代码 。 因 此 ， 我 仍然 认为 这 是 一 项 重大 变更 。 

也 有 可 能 存在 当 删 除 甚至 添加 其 他 依赖 时 可 能 会 导致 问题 的 场景 , 即使 这 些 问 题 从 模块 外 部 
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无 法 观察 到 ， 比 如 : 

D 添加 或 删除 普通 requires 指令 可 能 会 改变 可 选 依赖 的 解析 和 服务 绑 定 ; 

D 设置 一 项 依赖 为 可 选 ( 或 者 反 过 来 ) 也 有 可 能 改变 使 其 进入 模块 图 的 模块 。 
因此 ， 尽 管 requires 和 requires static 可 以 更 改 模块 图 ， 从 而 影响 与 你 完全 无 关 的 

模块 ， 但 是 很 多 人 不 知道 这 一 点 。 默 认 情 况 下 ， 我 不 会 将 这 样 的 更 改 视 为 重大 变更 。 
注意 ”尽管 所 有 这 些 听 起 来 可 能 很 糟糕 而 且 很 复杂 ,但 是 与 更 改 公有 API 中 的 类 相 比 也 
差 不 太 多 。 你 只 是 对 模块 声明 的 变更 如 何 影响 其 他 项 目 还 没有 直觉 ， 不 过 请 放心 ， 慢 慢 
会 有 的 。 


























15.3 ”技术 前 景 


在 1.4 节 首次 介绍 模块 系统 之 后 ， 我 认为 你 可 能 对 它 与 生态 系统 其 他 部 分 的 关系 还 有 一 些 疑 
问 。 你 可 能 还 记得 如 下 问题 。 
口 Maven 、Gradle 以 及 其 他 构建 工具 不 是 已 经 管理 好 依赖 关系 了 吗 ? 
口 又 或 是 开放 服务 网 关 协 议 ( Open Service Gateway Initiative，OSGi ) 呢 ? 为 什么 我 不 直接 用 它 ? 
D 在 微服 务 普 遍 流 行 的 时 代 ， 模 块 系统 是 否 矫 枉 过 正 ? 
我 将 在 一 分 钟 内 回答 这 些 问 题 , 但 是 首先 , 我 想 向 你 介绍 Java9 及 以 上 版 本 在 模块 系统 之 外 
必须 提供 的 功能 。 毕 竟 ,， 这 些 好 处 是 打包 提供 的 ， 如 果 你 对 其 中 一 个 持 怀 疑 态 度 ， 那么 也 许 男 一 
个 的 好 处 会 动摇 你 。 
























































15.3.1 Maven、Gradle 以 及 其 他 构建 工具 


Java 生态 系统 很 幸运 ， 其 拥有 一 些 经 过 实践 检验 的 强大 构建 工具 ， 比 如 Maven 和 Gradle。 
当然 ， 它 们 并 非 完美 ， 但 是 已 经 在 Java 世界 中 存在 10 多 年 了 ， 因 此 显然 拥有 自己 的 价值 。 

顾名思义 ,构建 工具 的 主要 工作 是 构建 项 目 , 包括 编译 、 测 试 、 打 包 和 发 布 。 尽 管 模块 系统 
涉及 其 中 许多 步 又, 并 且 需 要 对 工具 进行 一 些 更 改 , 但 它 并 没有 为 平台 添加 任何 功能 使 其 与 之 竞 
争 。 因 此 ， 在 构建 项 目 时 ，Java 平 台 与 这 些 构建 工具 之 间 的 关系 与 之 前 儿 乎 相同 。 



























































Java 9 及 以 上 版 本 的 构建 工具 

不 能 说 所 有 构建 工具 ， 至 少 Maven 和 Gradle 已 经 更 新 ， 并 可 以 在 Java 9 及 以 上 版 本 和 模 
块 系统 上 正常 使 用 。 所 需 的 更 改 主 要 是 内 部 的 ， 用 创建 模块 化 JAR 替代 普通 JAR， 需 要 做 的 
只 是 在 源 目 录 中 添加 module-info.java。 构 建 工具 获得 该 文件 ， 并 且 在 大 多 数 情 况 下 只 会 
做 正确 的 事情 。 

有 关 你 选择 的 构建 工具 如 何 与 模块 系统 或 其 他 Java 新 功能 ( 比如 多 版 本 JAR, 参 见 附录 玉 ) 
交互 的 详细 信息 ， 请 查看 相关 的 文档 。 我 想 明 确 提 到 一 件 事 ， 当 迁移 到 Java9 及 以 上 版 本 时 ， 
你 可 能 需要 增加 一 些 命令 行 选项 ， 因 此 你 可 能 希望 复习 一 下 相关 内 容 。 
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如 果 想 了 解 有 关 Gradle 的 更 多 信息 ， 请 参考 《实战 Gradle》 


1. 依赖 管理 

构建 系统 通常 执行 的 另 一 个 任务 ,， 即 依赖 关系 管理 ,Java 9 及 以 上 版 本 现在 也 会 执行 。 如 3.2 
节 所 述 ， 可 靠 配置 则 在 确保 依赖 存在 且 无 歧义 ， 从 而 使 应 用 程序 变 得 更 加 稳定 Maven 或 
Gradle 也 为 你 做 同样 的 事情 。 这 是 否 意味 着 模块 系统 将 取代 构建 工具 ? 还 是 为 时 已 晚 , 这 些 新 功 
能 并 没有 用 ?从 表面 上 看 , 模块 系统 似乎 复制 了 构建 工具 的 功能 , 但 是 当 你 仔细 观察 时 ， 你 会 发 
现 重 炙 很 小 。 

首先 , 模块 系统 无 法 唯一 地 标识 或 定位 工件 。 最 值得 注意 的 是 , 它 没 有 版 本 的 概念 ， 这 意味 
着 在 给 定 相同 工件 的 几 个 不 同 版 本 时 ， 它 无 法 选择 正确 的 版 本 。 正 是 因为 它 是 模棱两可 的 ， 所 以 
这 种 情况 将 导致 错误 。 

尽管 许多 项 目 会 选择 一 个 可 能 具有 唯一 性 的 模块 名 称 ( 比如 反问 域名 命名 规则 ,其 中 的 域名 
与 项 目 关 联 ), 但 因为 没有 像 Maven Central 这 样 的 实例 可 以 确保 这 一 点 ， 所 以 通过 模块 名 称 不 足 
以 唯一 地 标识 一 个 依赖 。 关 于 像 Maven Central 这 样 的 远程 存储 库 ， 模 块 系统 并 不 支持 连接 到 它 
们 。 因 此 ,尽管 模块 系统 和 构建 工具 都 管理 依赖 关系 , 但 是 前 者 的 执行 水 平 太 过 抽象 以 至 于 无 法 
蔡 代 后 者 。 

不 过 , 构建 系统 确实 存在 一 个 相当 大 的 缺点 : 它们 能 确保 依赖 在 编译 过 程 中 存在 ,其 至 可 以 
将 其 交付 到 你 的 “门口 "， 但 是 不 能 管理 应 用 程序 的 启动 。 如 果 该 工具 没有 意识 到 间接 需要 的 依 
赖 〈 由 于 使 用 了 Maven 的 broviaea 或 者 Gradle 的 compileonly ), 或 者 类 库 在 构建 至 启动 的 
过 程 中 丢失 了 ， 那 么 这 些 情 况 只 能 在 运行 时 才 发 现 ， 从 而 很 可 能 导致 应 用 程序 前 泪 。 另 一 方面 ， 
模块 系统 不 仅 在 编译 时 而 且 在 运行 时 管理 直接 和 间接 的 依赖 ,以 确保 所 有 阶段 的 可 靠 配置 。 它 还 
可 以 更 好 地 检测 卜 义 , 比如 重复 的 工件 或 包含 相同 类 型 的 工件 。 因 此 , 如 果 你 深入 研究 依赖 管理 ， 
会 发 现 两 种 技术 也 有 所 不 同 ， 唯 一 的 交集 是 两 者 都 以 某 种 形式 列 出 各 个 依赖 。 


2. 封装 、 服 务 和 链接 

说 完 依赖 管理 , 我 们 迅速 找到 了 构建 工具 不 足以 与 模块 系统 抗衡 的 功能 。 最 值得 注意 的 是 强 
封装 (参见 3.3 节 ), 它 使 类 库 可 以 在 编译 时 和 运行 时 对 其 他 代码 隐藏 实现 细节 一 一 Maven 或 Gradle 
甚至 做 梦 都 无 法 实现 的 特性 。 这 种 严格 性 需要 一 段 时 间 才 能 适应 ,但 从 长 远 来 看 ，JDK、 框 架 、 
类 库 甚至 大 型 应 用 程序 , 都 将 受益 于 受 支持 API 和 内 部 API 的 严格 区 分 , 并 确保 不 会 意外 地 依赖 
于 后 者 。 在 我 看 来 ， 仅 强 封装 本 身 就 值得 我 们 升级 到 模块 系统 。 

纵 观 更 高 级 的 特性 ,其 中 有 两 个 特别 有 趣 的 特性 超出 了 构建 工具 的 范围 。 首 先 模块 系统 可 以 
作为 服务 定位 模式 中 的 服务 注册 表 来 操作 ， 人 允许 你 解 耦 工件 ， 并 实现 易于 使 用 插件 的 应 用 程序 
(参见 第 10 章 )。 其 次 是 将 所 需 的 模块 链接 到 一 个 自 包含 的 运行 时 镜像 的 能 力 ， 使 你 有 机 会 简化 
部 署 (参见 第 14 前 。 

总 之 , 除了 在 依赖 管理 方面 有 一 些 重 又 , 构建 工具 和 模块 系统 并 不 相互 竞争 ， 而 应 该 被 看 作 
相互 补充 。 图 15-4 显示 了 这 种 关系 。 
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记录 工件 记录 信 
村 下 载 工 件 服务 链接 


选择 编译 的 工件 
Ra 
重 答 功 能 


图 15-4 构建 工具 ( 左 ) 和 模块 系统 ( 右 ) 具有 非常 不 同 的 特性 集 。 唯 一 的 相似 之 处 
是 二 者 都 记录 依赖 (构建 工具 通过 全 局 唯一 标识 符 和 版 本 进行 记录 ; JPMS 只 
根据 模块 名 进行 记录 )， 并 为 编译 进行 验证 。 它 们 对 依赖 的 处 理 非常 不 同 ， 除 
此 之 外 ， 几 乎 没有 任何 共同 点 






















































































15.3.2 OSGiI 


开放 服务 网 关 协 议 是 OSGi 联盟 组 织 及 其 所 创建 的 规范 简称 。 在 某 些 场合 它 还 表示 规范 的 不 
同 实现 ， 本 节 就 是 如 此 。 

OSGi 是 一 个 基于 Java 虚拟 机 的 模块 系统 和 服务 平台 ， 与 JPMS 共享 部 分 特性 集 。 如 果 你 对 
OSGi 有 一 些 了 解 ， 或 者 已 经 使 用 过 0OSGi， 你 可 能 想 知道 它 与 Java 的 新 模块 系统 相 比 如 何 ， 以 
及 OSGi 是 否 已 经 被 新 模块 系统 所 取代 。 你 甚至 可 能 还 想 知道 我 们 为 什么 开发 了 模块 系统 
Java 不 能 只 使 用 OSGi 吗 ? 

















注意 ”如 果 你 只 通过 传 亲 了 解 OSGi， 那 么 掌握 这 一 节 可 能 有 点 困难 一 一 这 不 是 问题 ， 
因为 其 不 是 必需 阅读 的 内 容 。 如 果 仍 想 继续 学 习 , 请 先 想象 一 下 OSGi 与 模块 系统 相似 。 
本 节 的 其 余部 分 将 介绍 一 些 重要 的 区 别 。 


我 不 是 OSGi 专家 ， 但 我 在 研究 过 程 中 喜欢 上 了 OSGi in Depth 这 本 书 。 如 果 你 的 需求 超出 
Java 平台 模 块 系统 所 能 提供 的 范围 ， 请 考虑 使 用 它 。 


1. 为 何 JDK 不 使 用 OSGi 

为 什么 JDK 不 使 用 OSGi? 这 个 问题 的 技术 答案 可 以 归结 为 0SGi 实现 其 特性 集 的 方式 。 它 
严重 依赖 于 类 加 载 器 ，1.2 节 和 1.3.4 节 中 曾 简单 讨论 过 这 个 问题 , 0OSGi 实现 了 自己 的 类 加 载 器 。 
它 为 每 个 bundle (模块 在 OSGi 中 称 为 bundle ) 使 用 一 个 类 加 载 器 ， 并 以 此 方式 控制 一 个 bundle 
可 以 看 到 哪些 类 ( 并 对 其 实现 封装 ), 或 者 当 一 个 bundle 被 外 载 (OSGi 所 允许 的 一 一 稍 后 将 详细 
介绍 ) 时 会 发 生 什么 。 

看 起 来 像 是 技术 细节 的 东西 会 产生 深远 的 影响 。 在 JPMS 之 前 ，Java 对 类 加 载 器 的 使 用 没有 
任何 限制 ， 并 且 使 用 反射 API 按 名 称 访问 类 是 常见 的 用 法 。 
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如 果 JPMS 需要 特定 的 类 加 载 器 架构 ,那么 Java9 及 以 上 版 本 将 彻底 破坏 JDK、 许 多 现 有 的 
类 库 和 框架 ， 以 及 关键 的 应 用 程序 代码 。Java9 及 以 上 版 本 仍然 会 带 来 迁移 方面 的 挑战 ， 但 是 更 
改 类 加 载 器 API 带 来 的 不 兼容 性 会 导致 更 大 的 破坏 , 不 但 不 会 减轻 兼容 性 挑战 , 反而 兼容 性 问题 
会 变 得 更 加 严重 。 因 此 ，JPMS 在 类 加 载 器 之 下 运行 ， 如 图 15-5 所 示 。 
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图 15-5 OSGi ( 左 ) 建立 在 JVM 之 上 ，JVM 迫使 它 使 用 现 有 的 功能 ， 主 要 是 类 加 载 
基础 设施 ， 来 实现 其 特性 集 。 另 一 方面 ， 模 块 系统 〈 右 ) 在 类 加 载 机 制 之 下 
的 JVM 层面 实现 ， 以 保持 在 其 上 构建 系统 的 运作 

使 用 类 加 载 器 进行 模块 隔离 的 另 一 个 后 果 是 ， 虽 然 OSGi 使 用 它们 来 缩小 类 的 可 见 性 , 但 不 
能 降低 可 访问 性 。 这 是 什么 意思 呢 ? 假设 一 个 lib bundle 有 一 个 Feature 类 型 , 但 包含 该 类 型 的 
包 没 有 导出 。 然 后 OSGi 确保 另 一 个 app bundle 中 的 代码 不 能 “看 到 ”Feature， 例 如 ，class . 
forname ("org.1ib.Feature") 将 抛 出 一 个 ClassNotFoundException ( Feature 并 不 可 见 )。 

但 是 现在 假设 lib 有 一 个 API, 以 object 类 型 返回 一 个 Feature 对 象 。 在 这 种 情况 下 , app 
可 以 获得 类 的 实例 。 然 后 ， app 可 以 调用 featureobject .getCclass() .newinstance () ， 计 
创建 一 个 新 的 Feature 实例 ( Feature 是 可 访问 的 )。 

如 同 3.3 节 所 讨论 的 那样 ,， JPMS 需要 保证 强 封 装 , 而 OSGi 提供 的 内 容 又 谈 不 上 强 封装 。 如 
果 你 创建 了 像 之 前 一 样 包含 两 个 JPMS 模块 app 和 lib 且 lib 包含 但 未 导出 的 Feature 类 型 ， 那 
么 app 可 以 成 功 地 通过 class.forName ("org.1ib.Feature")( 它 是 可 见 的 ) 得 到 一 个 类 实 
例 但 不 能 对 其 调用 newInstance()( 它 是 不 可 访问 的 ),。 表 15-1 对 比 了 OSGi 和 JPMS 的 区 别 。 


表 15-1 OSGi 的 可 见 性 和 JPMS 的 可 访问 性 限制 













































































OSGi JPMS 
限制 可 见 性 (class: :forName 失 败 ) v x 
限制 可 访问 性 (class::newInstance 失 败 ) X v 





2. JPMS 可 以 取代 OSGi 吗 

JPMS 可 以 取代 OSGi 吗 ? 不 可 以 。 

JPMS 最 初 是 为 了 模块 化 JDK 而 开发 的 。 它 涵盖 了 所 有 模块 化 的 基础 特性 一 一 其 中 一 些 ， 
比如 封装 ， 可 以 说 比 OSGi 更 好 一 一 但 OSGi 有 很 多 JPMS 不 需要 的 特性 ， 因 此 JPMS 没有 对 应 
的 实现 。 

举例 来 说 ， 由 于 0SGi 的 类 加 载 器 策略 ， 你 可 以 在 几 个 bundle 中 拥有 相同 的 完全 限定 类 型 ， 
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这 也 使 得 同时 运行 同一 个 bundle 的 不 同 版 本 成 为 可 能 。 在 这 种 情况 下 , 使 用 OSGi 可 以 对 导出 和 
导入 进行 版 本 控制 ， 让 bundle 表达 它们 是 什么 版 本 以 及 其 依赖 是 什么 版 本 。 如 果 一 个 bundle 需 
要 男 一 个 bundle 的 两 个 不 同 版 本 ，OSGi 就 可 以 做 到 这 一 点 。 

另 一 个 有 趣 的 区 别 是 , 在 OSGi 中 bundle 通常 表达 对 包 的 依赖 ,而 不 是 对 bundle 的 依赖 。 虽 
然 两 者 都 是 可 能 的 ， 但 前 者 是 默认 的 。 这 使 得 依赖 关系 在 替换 或 重 构 bundle 时 更 加 健壮 ， 因 为 
包 来 自 何 处 并 不 重要 ( 另 一 方面 ,在 JPMS 中 ,一 个 包 必须 位 于 一 个 模块 中 ， 因 此 将 一 个 包 移 至 
另 一 个 模块 中 ， 或 者 使 用 相同 的 API 将 一 个 模块 奉 换 为 另 一 个 模块 会 导致 问题 )。 

OSGi 的 一 个 重要 特性 是 于 绕 动 态 的 行为 ， 其 根源 是 物 联网 服务 网 关 通 过 类 加 载 器 实现 了 强 
大 的 功能 。 在 运行 时 ，OSGi 允许 bundle 出 现 、 消 失 ， 甚 至 更 新 ， 并 且 公 开 了 API， 让 依赖 做 出 
相应 的 反应 。 这 不 仅 对 于 跨 多 个 设备 运行 的 应 用 程序 非常 有 用 , 而 且 对 于 希望 最 大 程度 减少 停机 
时 间 的 单 服 务 器 系统 也 非常 有 用 。 

底线 是 如 果 你 的 项 目 已 经 使 用 了 OSGi， 那 么 所 依赖 的 功能 很 可 能 是 JPMS 所 没有 的 。 在 这 
种 情况 下 ,没有 理由 切换 到 Java 的 原生 模块 系统 。 


3. 有 了 OSGi 就 不 用 JPMS 了 吗 

有 了 OSGi 就 不 用 JPMS 了 吗 ? 不 是 。 

对 于 每 个 用 例 来 说 ， 虽 然 我 刚才 介绍 的 方法 听 起 来 很 像 OSGi 比 JPMS 好 ,但 OSGi 从 未 被 
广泛 采用 。 它 开辟 了 一 个 小 众 市 场 并 取得 了 成 功 , 但 从 未 成 为 一 种 默认 技术 (不 像 IDE、 构 建 工 
具 和 日 志 记 录 等 )。 

OSGi 未 被 广泛 采用 的 主要 原因 是 其 复杂 性 ， 不 管 被 认为 是 复杂 的 还 是 真 的 复杂 ， 不管 是 模 
块 化 固有 的 复杂 性 还 是 由 OSGi 带 来 的 复杂 性 ， 原 因 是 次 要 的 ， 因 为 大 多 数 开 发 人 员 认 为 OSGi 
很 复杂 因而 默认 不 使 用 它 。 

JPMS 则 不 同 。 首 先 ，JPMS 支持 的 特性 较 少 ( 特别 是 不 支持 版 本 ， 依 赖 于 模块 而 不 是 包 )， 
这 就 降低 了 其 复杂 性 。 此 外 ， 还 受益 于 JDK 的 内 在 支持 ， 所 有 Java 开发 人 员 都 在 一 定 程 度 上 接 
触 过 JP 了 MS ， 特 别 是 资深 的 开发 人 员 ， 他 们 将 探索 JPMS 如 何 帮 助 他 们 改善 项 目 。 这 种 广泛 的 使 
用 也 将 促进 工具 集成 的 进度 。 

因此 ， 如 果 一 个 团队 已 经 具备 了 相应 的 技能 和 工具 ， 并 且 使 用 过 JPMS ， 那 么 为 什么 不 将 整 
个 应 用 程序 模块 化 呢 ? 此 步骤 建立 在 现 有 知识 的 基础 上 , 减少 了 额外 的 复杂 性 , 并 且 不 需要 新 的 
工具 ,但 提供 了 很 多 好 人 处。 

最 后 , 由 于 Java9 及 以 上 版 本 中 引入 了 模块 化 , 因此 OSGi 也 能 从 JPMS 中 获 利 , 就 像 Java 8 
中 引入 函数 式 编程 那样 。 两 个 版 本 都 引入 了 开发 人 员 关 注 的 主流 Java 新 思想 ， 教 给 了 他 们 一 种 
全 新 的 技能 。 在 某 种 程度 上 ， 当 一 个 项 目 有 望 从 函数 式 编程 或 强大 的 模块 化 中 受益 时 ， 其 开发 人 
员 有 足够 的 学 习 动 力 ， 并 从 中 收获 “有 用 的 知识 ”。 

4. JPMS 与 OSGi 兼容 吗 


JPMS 和 0OSGi 兼容 吧 ?” 从 某 种 意义 上 说 , 二 者 兼容 。 使 用 OSGi 开发 的 应 用 程序 就 像 在 早期 
版 本 中 运行 一 样 ， 可 以 在 Java 9 及 以 上 版 本 中 运行 (更 准确 地 说 ， 运 行 在 无 名 模块 中 ，8.2 节 对 
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此 进行 过 详细 说 明 )。OSGi 不 需要 任何 迁移 ,但 是 应 用 程序 代码 面临 着 与 其 他 代码 相同 的 挑战 。 

从 另 一 种 意义 上 来 说 ，OSGi 是 否 允 许 我 们 将 bundle 映射 到 JPMS 模块 仍然 是 一 个 悬而未决 
的 问题 。 目 前 ，OSGi 没 有 使 用 JPMS 的 功能 ， 而 是 继续 独立 实现 自身 的 特性 。 同 样 不 清楚 的 是 ， 
为 将 OSGi 改造 成 了 PMS 而 付出 巨大 的 努力 是 否 值 得 。 


15.3.3 ”微服 务 


模块 系统 和 微服 务 架 构 之 间 的 关系 有 以 下 两 个 不 同 寻 常 的 方面 : 
口 微服 务 和 模块 系统 存在 竞争 吗 ? 如 何 比较 ? 
口 如 果 使 用 微服 务 ， 模 块 系统 是 否 与 其 有 关 ? 
本 市 将 讨论 这 两 个 问题 。 
如 果 你 不 熟悉 微服 务 架构 , 可 以 跳 过 本 节 。 但 如 果 你 想 了 解 更 多 , 有 很 多 很 棒 的 微服 务 图 书 。 
为 了 研究 这 个 问题 ， 我 略 读 了 Microservices in Action 这 本 书 。 

































































1. 微服 务 与 JPMS 

一 般 来 说 ,项目 越 大 模块 系统 带 来 的 好 处 就 越 明 显 。 因 此 ， 当 每 个 人 都 在 谈论 微服 务 时 ， 大 
型 应 用 程序 的 模块 系统 难道 不 是 会 带 来 显而易见 的 好 处 吗 ? 答 案 取 决 于 最 终 有 多 少 项 目 将 被 构 
建 为 微服 务 ， 当 然 ， 这 本 身 就 是 一 个 巨大 的 议题 。 

有 些 人 认为 微服 务 是 未 来 的 趋势 , 所 有 的 项 目 迟 早 都 会 走 上 这 条 路 一 一 全 部 是 微服 务 ! 如 果 
你 持 有 这 种 观点 , 那么 你 仍然 能 使 用 Java 9 及 以 上 版 本 实现 微服 务 , 而 模块 系统 将 影响 你 。 但是， 
当然 模块 化 对 整体 项 目的 影响 要 小 得 多 。 下 一 节 中 将 讨论 。 

其 他 人 的 看 法 则 更 为 谨慎 。 与 所 有 架构 风格 一 样 ,微服 务 既 有 优点 也 有 缺点 ,必须 在 考虑 到 
项 目 需求 的 情况 下 , 在 两 者 之 间 进 行 权衡 。 微 服务 在 需要 承受 高 负荷 的 复杂 项 目 中 表现 得 尤其 突 
出 ， 在 这 些 项 目 中 ， 微 服务 的 可 伸缩 能 力 几 乎 无 可 匹敌 。 

但 是 , 这 种 可 伸缩 性 的 代价 是 复杂 性 ， 因 为 运行 大 量 的 服务 需要 更 多 的 知识 和 基础 设施 ,而 
不 是 在 负载 均衡 器 后 面 放置 少量 相同 服务 的 实例 。 男 一 个 缺点 是 ,如 果 错 误 地 划分 了 服务 边界 ( 团 
队 对 领域 知识 了 解 得 越 少 ， 就 越 有 可 能 发 生 这 种 情况 )， 在 微服 务 中 修复 该 问题 的 代价 要 比 在 单 
一 式 应 用 程序 中 昂贵 得 多 。 

关键 的 观察 结果 是 ， 必 须 始 终 支 付 复杂 性 的 代价 (Martin Fowler 称 之 为 微服 务 溢价 )， 便 
只 有 当 项 目 足 够 大 时 才能 获得 收益 。 这 一 因素 使 许多 开发 人 员 和 架构 师 相 信 , 大 多 数 项 目 应 该 从 
单一 式 应 用 程序 开始 ， 并 朝 着 分 拆 服务 的 方向 发 展 ， 一 旦 环境 需要 最 终 可 能 采用 微服 务 。 

例如 ，Martin Fowler 引用 了 他 同事 们 的 以 下 观点 。 
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在 一 个 新 项 目 中 不 应 该 一 开始 就 使 用 微服 务 , 即使 你 确信 应 用 程序 足够 庞大 ,值得 
一 试 。……: 合理 的 方法 是 认真 设计 单一 式 应 用 程序 ， 并 注意 软件 内 部 的 模块 化 ， 包 括 
API 边界 和 数据 存储 方式 。 做 好 这 一 点 ， 转 向 微服 务 是 一 件 相 对 简单 的 事情 。 


到 目前 为 止 ， 本 书 所 强调 的 短语 你 应 该 很 熟悉 了 : 仔细 设计 、 模 块 化 、 边 界 一 一 这 些 都 是 模 
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块 系统 所 改善 的 特性 ( 参见 1.5 市 )。 在 微服 务 架 构 中 ， 服 务 依赖 关系 应 该 是 清晰 的 ( 可 靠 配置 ) 
和 理想 的 解 耘 (服务 加 载 器 API )。 此 外 ， 所 有 请 求 都 必 ~ API( 强 封装 )。 如 果 时 机 成 
熟 , 谨慎 使 用 模块 系统 可 以 为 成 功 迁 移 到 微服 务 打下 基础 。 图 15-6 显示 了 这 种 精心 设计 的 重要 性 。 

































































在 这 个 i 单一 式 应 用 程序 中 ， 各 种 关注 这 个 单一 式 应 用 程序 具有 模块 化 的 体 
点 重 倒 并 纠缠 在 一 起 将 其 重 构 为 系 结构 ， 并 清晰 地 分 离 了 关注 点 一 一 
>” 扑 常 困难 国 构 为 微服 务 相 当 容 易 
图 一 一 | 国 



































































































































se》 四 加 辐 加 目 中 器 总 
二 | | 国 转 国 | 品目 口 

































































图 15-6 ”假设 将 两 个 单一 式 应 用 程序 迁移 到 微服 务 ， 你 是 愿意 从 一 团 乱 麻 ( 左 ) 开始 
迁移 ， 还 是 从 适当 模块 化 的 代码 库 〈 右 ) 开始 ? 


尽管 模块 系统 侧重 于 更 大 的 项 目 ， 但 即使 是 小 的 服务 也 可 以 从 模块 化 中 获 益 。 


2. 使 用 JPMS 的 微服 务 

如 果 你 的 项 目 使 用 的 是 微服 务 , 并 且 期 望 从 改进 的 安全 性 和 性 能 中 获 益 , 你 基于 Java 9 及 以 
es 那么 你 必须 与 模块 系统 进行 交互 ， 因 为 它 就 在 运行 代码 的 JVM 中 
运转 。 能 的 结果 是 ， 服 务 仍 然 有 第 6 章 和 第 7 章 中 讨论 的 潜在 问题 需要 修复 。 随 着 时 间 的 
推移 ， 1 但 是 正如 8.1.3 节 所 描述 的 ， 这 并 不 会 强迫 将 你 
的 所 有 工件 都 改造 成 模块 。 

如 果 你 决定 将 所 有 JAR 都 放 在 类 路 径 上 ， 它 们 之 间 就 不 会 强制 进行 强 封 装 。 因 此 ， 在 这 组 
JAR 中 ， 对 内 部 API 以 及 反射 ( 比如 从 框架 到 代码 的 反射 ) 的 访问 将 继续 工作 。 在 这 个 场景 
你 对 模块 系统 的 了 解 仅 限于 它 对 JDK 的 变更 。 

另 一 种 方法 是 将 服务 和 依赖 进行 模块 化 ， 这 样 就 可 以 完全 集成 到 模块 系统 中 。 在 各 种 好 处 
中 ， 最 相关 的 可 能 是 1.6.5 节 中 的 简要 描述 以 及 第 14 章 中 详细 讨论 的 可 伸缩 平台 ， 其 允许 你 使 
用 jlink。 

使 用 jlink, 你 可 以 创建 一 个 小 尺寸 的 运行 时 镜像 ( 其 中 包含 一 组 正确 的 平台 模块 以 及 你 创 
建 的 模块 ) 来 支持 你 的 应 用 程序 ,并 且 可 以 将 镜像 减少 80%。 此 外 ， 当 将 所 需 的 模块 链接 在 一 起 
时 , jlink 可 以 利用 它 纵 观 整个 应 用 程序 而 得 到 的 知识 来 分 析 字 节 码 , 因此 可 以 进行 更 深入 的 优 
化 ， 从 而 进一步 压缩 镜像 以 及 小 幅 提升 性 能 。 你 也 会 得 到 其 他 的 好 处 : 例如 ,确定 只 使 用 自身 依 
赖 的 公有 API。 
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15.4 ”关于 模块 化 生态 系统 的 思 


Java9 及 以 上 版 本 是 一 个 大 版 本 。 尽 管 缺乏 新 的 语言 特性 ， 但 其 包含 了 许多 强大 的 改进 和 附 
加 功能 。 但 这 些 改进 都 被 Java 平台 模块 系统 掩盖 了 。 它 很 容易 成 为 Java 9 及 以 上 版 本 最 受 期 待 
和 最 具 争 议 的 特性 ， 尤 其 是 因为 它 带 来 的 迁移 挑战 。 

尽管 在 走向 模块 化 未 来 的 道路 上 有 时 会 遇 到 一 些 困难 ,但 是 知名 的 类 库 和 框架 很 快 就 支持 了 
Java9 及 以 上 版 本 ， 而 且 从 那 时 起 ， 这 种 趋势 就 没有 任何 放 缓 的 迹象 。 那 么 较 旧 的 、 支 持 较 少 项 
目的 类 库 和 框架 呢 ? 尽管 有 些 可 能 会 有 新 的 维护 者 ， 即 使 只 是 为 了 在 当前 的 Java 版 本 中 工作 ， 
但 是 Java 项 目的 长 尾 可 能 会 变 细 。 

这 肯定 会 引起 一 些 依赖 于 此 类 项 目的 开发 人 员 的 不 满 , 这 是 可 以 理解 的 一 一 没有 人 愿意 在 没 
有 明显 好 处 的 情况 下 去 修改 代码 。 与 此 同时 , 一 些 不 再 具有 吸引 力 的 老 旧 项 目 将 给 其 他 项 目 带 来 
获取 用 户 的 机 会 。 谁 知道 呢 ? 也 许 他 们 终究 会 看 到 转换 的 好 处 。 

一 旦 升级 到 Java 9 及 以 上 版 本 的 浪潮 过 去 , 项 目 开 始 将 基线 提高 到 Java9 及 以 上 版 本 ,你 就 
会 看 到 越 来 越 多 的 公开 的 模块 化 JAR。 由 于 模块 系统 支持 增 量 式 和 分 散 式 模块 化 , 因此 该 过 程 对 
项 目 间 的 协调 要 求 相对 较 少 。 它 还 让 你 有 机 会 立即 开始 模块 化 项 目 。 

这 样 做 的 目的 是 什么 呢 ? 与 Java 8 中 的 lambda 表达 式 和 流 , 或 Java 10 中 的 局 部 变量 类 型 推 
断 等 特性 不 同 , 模块 系统 对 代码 库 的 影响 是 微妙 的 。 你 不 可 能 只 看 几 行 代码 就 感受 到 它 的 美 , 你 
也 不 会 突然 发 现 ， 在 编写 代码 的 时 候 有 了 更 多 的 乐趣 。 

模块 系统 的 优点 则 在 男 一 方面 。 由 于 可 靠 配置 , 你 将 尽早 捕获 更 多 的 错误 。 由 于 更 加 深入 了 
解 了 项 目 架 构 ， 你 将 避免 无 谓 的 过 失 。 你 不 会 轻易 地 使 代码 陷 人 混乱 之 中 , 也 不 会 意外 地 依赖 于 
依赖 项 的 内 部 。 

JPMS 会 改进 软件 开发 中 喜人 经 无 常 的 部 分 。 模 块 系统 不 是 万 能 的 : 你 仍然 需要 投入 大 量 的 工 
作 来 正确 地 设计 和 安排 工件 , 但 是 有 了 模块 系统 ， 这 项 工作 会 有 更 少 的 陷阱 和 更 多 的 捷径 。 

随 着 生态 系统 中 越 来 越 多 的 工件 变 得 模块 化 , 这 种 影响 只 会 越 来 越 强 , 直到 有 一 天 我 们 会 问 
自己 ， 我 们 是 如 何在 没有 模块 系统 的 情况 下 进行 编码 的 。 在 JVM 把 我 们 精心 设计 的 依赖 关系 图 
变 成 “大 泥 球 ” 的 那些 日 子 里 ， 我 们 是 如 何 应 对 的 ? 

回想 起 来 会 觉得 很 奇怪 ,与 编写 没有 private 的 Java 类 一 样 奇怪 ， 你 能 想象 那 会 是 什么 样 
子 吗 ? 















































































































































15.5 小结 


口 仔细 设计 你 的 模块 系统 。 

口 微服 务 和 JPMS 是 相辅相成 的 。 

口 OSGi 和 JPMS 也 是 相辅相成 的 。 

现在 一 一 非常 感谢 你 阅 本 书 ， 我 很 高 兴 能 为 你 们 撰写 本 书 。 我 相信 我 们 还 会 再 见 的 ! 



































类 路 径 回 顾 


























讨论 模块 系统 的 书 当然 会 聚焦 于 模块 路 径 ( 参见 3.4 节 )， 但 是 类 路 径 仍然 能 正常 工作 。 
为 可 以 将 类 路 径 与 模块 路 径 一 起 使 用 , 所 以 类 路 径 在 逐步 模块 化 的 过 程 中 扮演 着 重要 角色 。 换 名 
话说 ， 了 解 类 路 径 的 工作 原理 还 是 很 有 价值 的 。 


A.1 使 用 类 路 径 加 载 应 用 程序 JAR 


定义 : 类 路 径 

类 路 径 是 一 个 与 编译 器 和 虚拟 机 相关 的 概念 。 它 们 使 用 类 路 径 的 目的 相同 : 在 列 出 的 JAR 
文件 中 搜索 需要 的 类 型 ， 因 为 这 些 类 型 在 JDK 中 不 存在 ( 类 路 径 也 可 以 与 类 文件 一 起 使 用 ， 
不 过 为 了 了 解 模 块 系统 ， 你 可 以 忽略 这 种 情况 )。 








以 本 书 的 示例 应 用 程序 ServiceMonitor 为 例 。 它 由 多 个 子 项 目 组 成 ， 并 具有 一 些 依赖 关系 。 
在 这 个 场景 中 ， 除 了 最 后 一 个 子 项 目 monitor， 所 有 子 项 目 都 已 经 构建 完毕 ， 并 出 现在 了 jars 目 
录 中 。 

代码 清单 A-1 显示 了 如 何 使 用 类 路 径 编译 、 打 包 和 启动 应 用 程序 。 除 了 一 些 命 令 行 选项 的 变 
化 〈 例 如， 使 用 --class-path， 而 不 是 -classpath )， 这 些 命令 与 Java 9 之 前 的 用 法 完全 相同 。 


代码 清单 A-1 使 用 类 路 径 编 译 、 打 包 和 启动 应 用 程序 
















































































包含 以 JAR 形式 存在 存放 已 编译 类 的 目录 列 出 或 找到 所 有 源 文 件 ， 本 例 中 是 monitor/ 
的 依赖 的 目录 src/main/java/monitor/Main.java 和 monitor/ 
javac src/main/java/monitor/Monitor.java 
> --class-path "jars/*" 


-d monitor/target/classes 


sfjava-ftilesj 4 命名 新 的 JAR 文件 并 放 到 jars 中 
jar --create 2 
--file jars/monitor.jar 已 编译 类 的 目录 


-C monitor/target/classes . 





java 
> --Class-path "jars/*" 包含 应 用 程序 main 
monitor.Main -<4 函数 的 类 


编译 器 和 运行 时 都 会 搜索 类 路 径 以 找到 需要 的 类 型 ， 但 二 者 有 如 下 区 别 。 
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要 编译 代码 引用 的 类 型 。 这 些 是 项 目的 直接 依赖 ， 或 者 更 准确 地 说 ， 








编译 器 一 一 编译 带 需 

是 编译 文件 引用 的 直接 依赖 中 的 类 型 。 

口 虚拟 机 一 一 JVM 需要 已 执行 的 字 节 码 引 用 的 所 有 类 型 。 一 般 来 说 ， 这 些 是 项 目的 直接 和 
间接 依赖 。 但 由 于 Java 在 类 加 载 方面 的 延迟 性 ， 实 际 的 依赖 可 能 会 少 得 多 。 只 有 实际 运 
行 的 代码 引用 的 类 型 是 必需 的 ， 这 意味 着 如 果 不 执行 引用 它 的 代码 ， 就 可 能 丢失 依赖 项 。 
JVM 还 允许 代码 搜索 JAR 文件 来 查找 资源 。 

javac 和 java 都 有 命令 行 选项 -classpath 和 -cp， 自 Java 9 以 来 还 有 --class-path。 


它们 通常 使 用 文件 列表 作为 输入 ， 但 也 可 以 使 用 路 径 和 通配符 ， 然 后 将 其 扩展 成 文件 列表 。 





















































A.2 Java 9 以 来 的 类 路 径 

要 点 “对 于 Java9 及 以 上 版 本 ,必须 强调 类 路 径 不 会 消失 ,并 且 会 以 与 早期 的 Java 
版 本 完全 相同 的 方式 运转 。 如 果 在 这 些 早 期 版 本 中 编译 的 应 用 程序 没有 造成 任何 
问题 ( 参见 第 6 章 和 第 7 章 ), 那么 它们 就 可 以 在 Java9 及 以 上 版 本 中 继续 以 相同 





的 命令 编译 。 


考虑 到 这 种 向 后 兼容 性 ， 问 题 依然 存在 ， 即 模块 系统 如 何 处 理 类 路 径 上 的 


门 都 是 无 名 模块 。 无 名 模块 是 一 种 常规 模块 , 但 它 有 一 些 特性 ,其 中 之 一 就 是 自动 读 取 所 有 解 
日 其 


类 型 。 简 而 言 之 ， 


它 1 
析 后 的 模块 。 对 于 位 于 类 路 径 上 的 模块 也 是 如 此 一 一 它们 将 被 像 普 通 的 JAR 一 样 对 待 ， 并 | 


类 型 也 是 无 名 模块 ， 会 忽略 模块 声明 。 无 名 模块 和 类 路 径 上 模块 都 是 迁移 过 程 的 一 部 分 ，8.2 放 


详细 介绍 过 迁移 过 程 。 


























反射 API 的 高 级 介绍 











反射 允许 代码 在 运行 时 检查 类 型 、 方 法 、 字 段 和 注解 等 ,并 将 如 何 使 用 它们 的 决定 从 编译 时 
推迟 到 运行 时 。 为 此 ，Java 的 反射 API 提供 了 class、Field、Constructor、Method.、 
Annotation 等 类 型 。 有 了 它们 ， 就 可 以 与 在 编译 时 不 知道 的 类 型 交互 : 例如 , 创建 未 知 类 的 实 
例 并 调用 其 方法 。 

反射 及 其 用 例 很 容易 变 得 很 复杂 , 我 不 打算 详细 解释 。 相反 , 本 附录 旨 在 让 你 对 反射 是 什么 、 
它 在 Java 中 什么 样子 ， 以 及 你 或 你 的 依赖 因 何 使 用 反射 有 一 个 高 层次 的 了 解 。 

之 后 ， 你 便 可 以 使 用 反射 或 学 习 更 详尽 的 教程 了 ， 比 如 Oracle 的 反射 API 。 但 更 重要 的 是 ， 
你 要 为 了 解 模 块 系统 对 反射 所 做 的 更 改 做 好 准备 ， 这 在 7.1.4 节 ， 特 别 是 第 12 章 中 有 所 讨论 。 

让 我 们 从 一 个 简单 的 示例 开始 〈 无 须 从 头 开始 )。 下 面 的 代码 段 创建 了 一 个 URL， 并 将 其 转 
换 为 字符 串 ， 然 后 打印 。 在 使 用 反射 之 前 ， 我 使 用 普通 的 Java 代码 。 

URL Url = new URL("http://exampleurl"); 


String urlString = url.toExternalForm(); 
System.out.println(urlString); 


我 决定 在 编译 时 (也 就 是 编写 代码 时 ) 创建 一 个 URL 对 象 ， 并 调用 其 中 的 一 个 方法 。 前 两 
行 可 被 描述 为 5 个 步骤 (虽然 这 种 方法 不 常见 )。 

(1) 引用 URL 类 。 

(2) 找到 使 用 单个 字符 串 作为 参数 的 构造 函数 。 

(3) 调用 构造 函数 并 传人 参数 http://exampleurl。 

(4) 定位 方法 toExternalForm。 

(5) 在 url 实例 上 调用 toExternalForm 方法 。 

代码 清单 B-1 显示 了 如 何 使 用 Java 的 反射 API 实现 这 5 个 步骤 。 


代码 清单 B-1 通过 反射 创建 一 个 URL 实例 ， 并 调用 它 的 toExternalForm 方法 































































































类 运转 所 在 的 class 获取 接受 一 个 string 
实例 是 反射 的 入 口 参数 的 构造 函数 
Class<?> urlClass = Class.forName ("java.net .URL"); 


Constructor<?> urlConstructor 
= urlClass.getConstructor(String.class); 
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使 用 它 创 建 一 个 新 实例 ， 
Object url = 并 用 给 定 字符 串 作为 参数 


urlConstructor.newInstance("http://exampleurl"); 





Method toExternalFormMethod = 获取 toExternalForm 方法 
urlClass.getMethod("toExternalForm"); 


Object methodCallResult = 调用 前 面 创建 的 实例 中 
toExternalFormMethod.invoke (url); 的 方法 


当然 , 使 用 反射 API 比 直 接 编写 代码 更 麻烦 。 但 是 通过 这 种 方式 , 一 些 曾经 需要 被 揉 进 代码 
的 细节 ( 比如 使 用 URL， 或 者 调用 哪个 方法 )， 现 在 变 成 了 字符 串 参 数 。 因 此 ， 你 不 必 在 编译 时 
选 定 URL 和 toExternalForm， 而 是 可 以 在 程序 运行 时 决定 选择 哪 种 类 型 和 方法 。 

大 多 数 这 样 的 用 例会 出 现在 “框架 ”中 ， 以 JUnit 为 例 ， 它 希望 执行 所 有 用 erTest 注解 的 方 
法 。 一 旦 找到 对 应 的 方法 ， 就 通过 getMethod 和 invoke 进行 调用 。 当 寻找 控制 器 和 请 求 映射 
时 ,Spring 和 其 他 Web 框架 的 工作 原理 类 似 。 另 一 个 用 例 是 可 扩展 应 用 程序 , 它们 期 望 在 运行 时 
加 载 用 户 提供 的 插件 。 


B.1 基本 的 类 型 和 方法 


反射 API 的 入 口 是 class: :forName。 在 其 简单 形式 中 ， 这 个 静态 方法 接受 一 个 完全 限定 
类 名 ， 并 返回 一 个 class 实例 。 你 可 以 使 用 该 实例 获取 字段 、 方 法 和 构造 函数 等 。 

要 获得 特定 的 构造 兄 数 ， 如 前 所 述 ， 可 以 用 构造 函数 参数 的 类 型 来 调用 getConstructor 
方法 。 类 似 地 ， 可 以 通过 调用 getMethoa 方法 并 传递 其 方法 名 和 参数 类 型 来 访问 特定 的 方法 。 

对 getMethod ("toExternalForm") 的 调用 没有 指定 任何 类 型 ， 因为 该 方法 没有 参数 。 下 
面 代 码 中 的 URL .openConnection (Proxy) 需要 Proxy 作为 参数 。 


Class<?> urlClass = Class.forName ("java.net .URL"); 
Method openConnectionMethod = urlClass 
.getMethod ("openConnection", Proxy.class); 























































































































调用 getconstructor 和 getMethod 返回 的 实例 分 别 是 constructor 和 Method 类 型 。 
为 了 调用 底层 成 员 ， 它 们 提供 了 类 似 constructor: :newInstance 和 Method: :invoke 这 样 
的 方法 。 后 者 的 一 个 有 趣 的 细节 是 , 需要 实例 作为 第 一 个 参数 来 调用 方法 ， 其 他 参数 将 传递 给 被 
调用 的 方法 。 

继续 openconnection 的 例子 。 


openConnectionMethod.invoke(url, someProxy); 


如 果 你 想 调用 一 个 静态 方法 ， 那 么 实例 参数 将 被 忽略 ， 并 且 可 以 为 null。 

除了 class、Constructor 和 Method 之 外 , 还 有 Fielda， 它 允许 对 实例 字段 进行 读 写 访 
问 。 调 用 实例 的 get 方法 以 获取 字段 在 该 实例 中 的 值 一 一 set 方法 在 指定 的 实例 中 设置 指定 值 。 

URL 类 有 一 个 类 型 为 string 的 protocol 实例 字段 , 对 于 URL http://exampleurl, 这 
个 字段 将 包含 "http"。 因 为 该 字段 是 私有 的 ， 所 以 下 面 的 代码 无 法 通过 编译 。 
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URL url = new URL("http://exampleurl"); 
// 无 法 访问 私有 字段 ~> 编译 错误 
Url Drotocool = ito 


下 面 是 如 何 用 反射 做 同样 的 事情 。 


// `Class<?> urlClass` 和 `Object url 与 之 前 一 样 

Field protocolField = urlClass.getDeclaredField("protocol"); 
Object oldProtocol = protocolField.get (url); 
protocolField.set (url, "https"); 


虽然 可 以 编译 , 但 是 调用 set 方法 仍然 会 导致 IllegalAccessException 异常 ， 因 为 
protocol 字段 是 私有 的 。 但 这 并 不 能 阻止 你 调用 。 












































B.2 ”通过 setAccessible 强 行 调 用 API 














反射 的 一 个 重要 用 例 是 通过 访问 非 公 有 类 型 、 方 法 和 字段 来 人 侵 API， 这 叫 作 深度 反射 。 开 
发 人 员 通 过 它 来 访问 本 来 不 能 被 API 访问 的 数据 ， 进 而 通过 设置 内 部 状态 来 解决 依赖 中 的 bug， 
并 使 用 正确 的 值 动态 地 填充 实例 ，Hibernate 就 是 这 样 做 的 。 

对 于 深度 反射 ， 在 使 用 Method 、Constructor 或 Fielg 实例 之 前 ， 只 需 调用 
setAccessible (true) 方 法 。 














// “Class<?> urlClass` 和 `Object url. 与 之 前 一 样 

Field protocolField = urlClass.getDeclaredField("protocol"); 
protocolField.setAccessible(true); 

Object oldProtocol = field.get (url); 

protocolField.set (instance, "https"); 


迁移 到 模块 系统 所 面临 的 一 个 挑战 是 模块 系统 移 除 了 反射 的 超 能 力 ， 这 意味 着 对 
setAccessible 的 调用 有 可 能 失败 。 要 了 解 更 多 的 信息 以 及 如 何 补 救 ， 请 查看 第 12 章 。 


B.3 将 注解 用 于 反射 代码 


注解 是 反射 的 重要 组 成 部 分 ， 事 实 上 ， 注 解 是 面向 反射 的 。 注 解 的 目的 是 提供 可 以 在 运行 时 
访问 的 元 信息 , 然后 影响 程序 的 行为 。 JUnit 的 arest 、Spring 的 econtroller 和 @RequestMapping 
都 是 注解 的 典型 例子 。 

所 有 重要 的 与 反射 相关 的 类 型 比如 Class.Field.Constructor、Method 和 Parameter a 
都 实现 了 AnnotatedElement 接口 。Javadoc 有 全 面 介 绍 注解 与 这 些 元 素 关系 的 文档 ( 直接 的 、 
间接 的 或 相关 的 ), 但 其 最 简单 的 形式 是 这 样 的 : getAnnotations 方法 返回 元 素 上 包含 的 注解 ， 
其 以 Annotation 实例 数组 的 形式 展现 ， 进 而 可 以 访问 这 些 实例 的 成 员 。 

但 是 在 模块 系统 的 上 下 文中 , 你 或 你 所 依赖 的 框架 如 何 处 理 注解 并 不 重要 , 重要 的 是 它们 只 
与 反射 一 起 工作 这 一 基本 事实 。 这 意味 着 你 看 到 的 任何 有 注解 的 类 都 会 在 某 个 时 候 使 用 反射 一 一 
如 果 该 类 在 一 个 模块 中 ， 则 不 一 定 能 开 箱 即 用 。 
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Java 9 引入 了 统一 日 志 体系 架构 ， 它 通过 单一 机 制 传递 JVM 生成 的 消息 ， 并 人 允许 你 使 用 复 
杂 的 命令 行 选 项 -log 选择 显示 哪些 消息 。 

你 可 以 使 用 它 来 观察 JVM 的 行为 ， 调 试 应 用 程序 〈 如果 存 在 问题 的 话 ) 或 定位 潜在 的 性 能 
改进 。 从 你 自己 的 项 目 中 可 以 知道 , 日 志 记 录 具 有 广泛 的 应 用 领域 , 因此 我 不 会 用 一 个 用 例 来 解 
释 ， 而 是 将 其 作为 整体 进行 研究 。 

初次 使 用 -xlog 可 能 会 有 些 吓人 , 但 我 们 将 逐步 探讨 该 选项 的 各 个 方面 。 本 附录 将 对 该 机 秆 
进行 粗略 的 了 解 一 一 5.3.6 节 展 示 过 如 何 用 它 来 调试 模块 化 应 用 程序 。 


注意 ”该 机 制 在 JVM 中 是 通用 的 ， 除 监视 模块 系统 以 外 ,还 具有 更 多 的 应 用 。 类 加 载 、 
垃圾 回收 、 与 操作 系统 的 交互 以 及 线程 处 理 一 一 你 可 以 用 相应 的 选项 来 分 析 所 有 这 些 方 
面 以 及 更 多 内 容 。 请 注意 ， 这 既 不 包括 诸如 Swing 日 志 之 类 的 JDK 消息 ， 也 不 包括 应 
用 程序 的 消息 ， 完 全 是 关于 JVM 本 身 的 。 


















































Ws 


C.1 什么 是 统一 日 志 


JVM 内 部 的 统一 日 志 架 构 类 似 于 你 可 能 已 用 于 应 用 程序 的 其 他 日 志 记 录 框 架 , 比如 Java Util 
Logging、Log4j 和 Logback。 它 会 生成 文本 消息 ， 附 加 一 些 元 信息 ， 比 如 标签 ( 描述 生成 消息 的 
子 系统 )、 日 志 级 别 (描述 消息 的 重要 性 ) 和 时 间 戳 ， 并 将 信息 打印 在 某 个 地 方 。 你 可 以 根据 需 
要 配置 日 志 记 录 的 输出 。 






































定义 : -Xlog 
java 命令 的 -X10g 选项 会 将 日 志 激活 。 这 是 此 机 制 的 唯一 标志 一 一 任何 进一步 的 配置 都 
紧 跟 在 该 选项 之 后 。 日 志 的 可 配置 方面 如 下 : 
口 要 记录 哪些 消息 ( 按 标记 和 /或 日 志 级 别 ); 
口 包括 哪些 信息 ( 比如 时 间 惟 和 进程 ID ); 
口 使 用 哪个 输出 ( 比如 输出 到 文件 )。 
本 附录 的 其 余部 分 将 依次 介绍 它们 。 
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在 开始 其 他 事情 之 前 , 先 来 看 一 下 -xlog 产生 的 消息 种 类 ， 


然后 查看 输出 一 一 
出 所 有 选 


JVM 子 系统 
会 生成 消息 


(比如 垃圾 收集 ) 


志 很 多 ( 你 没有 为 Java 提供 足够 的 详细 信息 来 启 
项 。 为 了 不 使 输出 过 多 ， 我 使 用 -version 来 运行 ， 其 会 输出 当前 的 Java 版 本 )。 


消息 有 一 个 或 多 个 标签 








志 级 别 人 他 元 信息 












如 图 C-1 所 示 。 执 行 java -XlLog， 





动 应 用 程序 ， 因 此 它 会 列 


可 以 使 用 -X10og 过 滤 消 息 

(使 用 选择 器 ， 、 定 义 要 
显示 的 内 容 (使 用 装 包 
以 及 指定 显示 输出 能 
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Message 















Fa 
“Selectors 
人 filter by 
tags/level 


Decoraters 
define what to 
show Console 


> 





Output decides 
where messages 
go 


Files 
> 
































图 C-1 许多 JVM 子 系统 ( 左 ) 生 成 消息 (中 )，-Xlog ; 


包含 的 信息 以 及 显示 的 位 置 ( 右 ) 


第 一 条 消息 中 的 其 中 一 


$ java -Xlog -version 


# 省 略 了 一 些 消息 
> [0.002s] [infol] [os 
# 省 略 了 许多 消息 








该 输出 显示 了 JVM 运行 了 多 长 时 间 (2 毫秒 )、 日 志 级 
息 。 让 我 们 看 看 如 何 影响 这 些 细节 。 


示 哪 些 消息 


通过 定义 成 对 的 <tag- set>=<level>【( 称 为 选择 器 )， 可 以 使 用 日 志 级 
过 all 选择 所 有 标签 


C.2 ”定义 应 该 显 


义 显示 的 日 志 内 容 。 可 以 通 


条 告诉 你 HotSpot 虚拟 机 开始 工作 。 


HotSpot i8 runming with glibe 2.23;, 





$ java -Xlog:all=warning -version 


# no log messages; great, 


warning free! 


下 面 来 试 一 下 另 一 个 标签 和 级 别 。 


， 级 别 是 可 选 的 ， 





选项 可 用 于 配置 要 看 到 的 消息 、 





NPTL 2.23 


别 (info )、 标 记 ( 仅 os ) 和 实际 消 





级 别 和 标签 来 确切 定 
默认 为 info。 使 用 方法 如 下 。 
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$ java -Xlog:logging=debug -version 


> [0.034s] [info] [logging] Log configuration fully initialized. 

> [0.034s] [debug] [logging] Available log levels: 

off, trace, debug, info, warning, error 

.034s] [debug] [logging] Available log decorators: [...] 

.034s] [debug] [logging] Available log tags: [...] 

.034s] [debug] [logging] Described tag combinations: 

.034s] [debug] [logging logging: Logging for the log framework itself 
.034s] [debug] [logging] Log output configuration: 

.034s] [debug] [logging] #0: stdout [...] 

.034s] [debug] [logging] #A: stderr [...] 


运行 成 功 ， 很 幸运 ! 因为 输出 内 容 太 多 ， 所 以 必须 忽略 其 中 一 部 分 , 但 是 请 相信 我 ,这 些 消 
息 包含 很 多 有 用 的 信息 。 然 而 ,你 不 必 这 样 做 : -Xlog :help 显示 相同 的 信息 , 但 输出 格式 更 好 
EE 
令 人 惊讶 的 细节 是 仅 当 消息 的 标记 与 给 定 的 标记 完全 匹配 时 , 才能 匹配 给 定 的 多 个 选择 右 
给 定 的 多 个 过 拉 器 ? 是 的 ， 选 择 右 可 以 通过 + 串联 多 个 标签 。 不 过 ， 消 息 必须 包含 要 选择 的 内 容 。 
因此 ， 比 如 使 用 gc ( 用 于 垃圾 回收 ) 与 gc+heap， 应 该 选择 不 同 的 消息 。 确 实 是 这 样 。 


java -Xlog:gc -version 























VVNY VY YY YY 
| 



























































[0.009s] [info] [gc] Using G1 

java -Xlog:gc+heap -version 
[0.006s] [infol] [gc,heap] Heap region size: 1M 
你 可 以 一 次 定义 多 个 选择 锅 ， 用 逗号 将 它们 隔 开 即 可 。 
java -Xlog:gc,gc+heap -version 


[0.007s] [infol] [gc,heap] Heap region size: 1M 
[0.009s] [info] [gc ] Using G1 


使 用 此 策略 获取 包含 特定 标志 的 所 有 消息 很 麻烦 。 幸运 的 是 , 有 一 种 更 简单 的 方法 : 使 用 通 
配 符 *， 其 可 以 与 单个 标签 一 起 使 用 ， 以 定义 一 个 匹配 包含 该 标签 所 有 消息 的 选择 器 。 


java -Xlog:gc*=debug -version 



































[0.006s] [infol] [gc,heap] Heap region size: 1M 
[0.006s] [debugl] [gc,heap] Minimum heap 8388608 
Initial heap 262144000 Maximum heap 4192206848 
# 此 处 省 略 了 大 约 24 条 消息 

[0.072s] [info ] [gc,heap,exit ] Heap 

# 省 略 了 展示 最 终 GC 统计 的 一 些 消息 


可 以 使 用 日 志和 选择 器 通过 3 个 简单 的 步骤 来 了 解 JVM 的 子 系统 。 

(1) 在 java -Xlog:help 的 输出 中 寻找 有 趣 的 标签 。 

(2) 在 -xlog:${tag_1}*,${tag_2}*,${tag_n}* 中 使 用 这 些 标签 来 展示 所 有 被 它们 标记 
的 消息 。 
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(3) 选择 性 地 用 -Xxlog:${tag}*=debug 切换 到 更 低 的 日 志 级 别 。 
这 些 步骤 决定 了 你 将 看 到 哪些 消息 。 现 在 看 一 下 它们 将 输出 到 哪里 。 


C.3 定义 消息 输出 位 置 


与 复杂 的 选择 器 相 比 ， 输 出 配置 则 更 简单 。 将 它 放 到 选择 器 之 后 ( 以 逗号 分 隔 )， 其 有 3 个 
合法 值 。 
口 stdout 一 一 默认 输出 。 如 果 没 有 被 重 定 向 , 则 显示 在 控制 台 上 ， 即 终端 窗口 。 在 IDE 中 ， 
它 通常 是 相应 的 标签 页 或 者 视图 。 

口 stderr 一 一 默认 错误 输出 。 如 果 没 有 被 重 定 向 , 则 显示 在 控制 台 上 , 即 终 端 窗口 。 在 IDE 
中 ， 它 通常 与 stdout 在 相同 的 标签 页 或 者 视图 中 ,但 是 用 红色 字体 打印 。 

口 file=<filename> 一 一 定义 一 个 文件 ， 将 所 有 消息 输出 到 其 中 。file= 是 可 选 的 。 

与 通用 日 志 框 架 不 同 ， 在 此 无 法 同时 使 用 两 个 输出 选项 。 

以 下 是 将 所 有 debug 消息 打印 到 application.log 文件 的 命令 。 


java -Xlog:all=debug:file=application.log -version 


还 有 更 多 的 得 出 选项 允许 基于 文件 斥 十 和 滚动 文件 数量 实现 日 志文 件 滚动 。 


C.4 定义 消息 包含 哪些 内 容 


如 前 所 述 ， 每 条 消息 都 包含 消息 文本 和 元 信息 。JVM 将 打印 哪些 额外 的 源 信 息 ， 可 以 通过 
装饰 需 来 配置 (参见 表 C-1 )。 这 个 字段 在 输出 位 置 和 另 一 个 冒号 之 后 。 

假如 你 想 在 控制 台中 为 所 有 垃圾 回收 调试 消息 打印 时 间 戳 、 毫 秘 为 单位 的 运行 时 间 以 及 线程 
ID。 下 面 是 相应 的 命令 。 


java -Xlog:gc*=debug:stdout:time,uptimemillis,tid -version 






























































































































































# 省 略 了 一 些 消息 
[2017-02-01T13:10:59.689+0100] [7ms] [18607] Heap region size: 1M 


表 C-1 -xlog 选项 可 用 的 装饰 器 。 信 息 总 是 以 这 个 顺序 打印 ， 描 述 列 基于 官方 文档 









































选 项 描 述 

level 日 志 消 息 所 关联 的 级 别 

pid 进程 标识 

tags 日 志 消息 所 关联 的 标签 集 

tid 线程 标识 

time ISO-8601 格式 的 当前 时 间 和 日 期 

timemillis 与 System.currentTimeMi1l1lis() 生 成 的 值 相同 
timenanos 与 System.nanoTime () 生 成 的 值 相同 





uptime JVM 启动 后 的 秒 数 ( 比如 6.567 秒 ) 
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( 续 ) 
选 项 描 述 
Uptimemillis JVM 启 动 后 的 毫秒 数 
uptimenanos JVM 启动 后 的 纳 秒 数 





C.5 配置 整个 日 志 管 道 


-Xlog 选项 的 正式 语法 如 下 。 


-Xlog:<selectors>:<output>:<decorators>:<output-options> 


-Xlog 选项 后 面 的 每 个 参数 都 是 可 选 的 , 但 是 如 果 使 用 其 中 一 个 , 就 需要 指定 它 前 面 的 所 有 
参数 。 选 择 需 是 标签 集合 和 日 志 级 别 的 配对 。 这 部 分 也 称 作 what-expression， 这 是 当 配 置 有 语 
法 错误 时 会 出 现 的 一 个 术语 。 你 可 以 用 output ( 简单 来 说 ， 即 终端 窗口 或 日 志文 件 ) 为 日 志 消 
息 定义 目标 位 置 ， 并 用 装饰 涡 定 义 消息 包含 哪些 内 容 (是 的 , 很 恼人 ,输出 机 制 和 其 他 输出 选项 
被 装饰 器 分 隔 开 了 )。 

如 想 获得 更 多 细节 ， 请 参考 在 线 文档 或 者 java -Xlog:help 的 输出 。 


java -Xlog:help 



























































-Xlog Usage: -Xlog[: [what][:[output][:[decorators] [:output-options]]]] 
where 'what' is a combination of tags and levels on the form 
tagl[+tag2...] [*] [=level][,...] 


Unless wildcard (*) is specified, only log messages tagged with 
exactly the tags specified will be matched. 


Available log levels: 
off, trace, debug, info, warning, error 


Available log decorators: 

time (t), utctime (utc), uptime (u), timemillis (tm), uptimemillis (um), 
timenanos (tn), uptimenanos (un), hostname (hn), pid (p), tid (ti), 
level (1), tags (tg) 

Decorators can also be specified as 'none' for no decoration. 


Described tag combinations: 
logging: Logging for the log framework itself 


Available log tags: 

. many, many tags ... ] 

Specifying 'all' instead of a tag combination matches all tag 
combinations. 





Available log outputs: 
stdout, stderr, file=<filename> 
Specifying %p and/or %t in the filename will expand to the JVM's PID and 
startup timestamp, respectively. 


Some examples: 
[... a few helpful examples to get you going ... ] 


利用 JDeps 分 析 项 目的 依赖 











JDeps 即 Java 依赖 分 析 工 具 ( Java Dependency Analysis Tool )， 这 是 一 个 命令 行 工具 ， 用 来 
处 理 Java 字 节 人 三 .class 文件 或 者 包含 这 些 文件 的 JAR， 并 对 类 间 静 态 声明 的 依赖 进行 分 析 。 
分 析 结 果 可 以 被 多 种 方式 过 滤 , 并 且 可 以 被 聚合 到 包 或 JAR 级 别 , JDeps 同样 完全 支持 模块 系统 。 

总 之 ， 这 对 分 析 本 书 中 大 量 谈论 的 各 种 ( 有 时 模糊 不 清 的 ) 图 来 说 是 一 个 很 有 用 的 工具 。 不 
仅 如 此 ， 当 迁移 和 模块 化 某 个 项 目 时 ， 比 如 分 析 对 JDK 内 部 API 的 静态 依赖 ( 参见 7.1.2 前 、 
列 出 包 分 裂 (参见 7.2.5 节 ) 以 及 起 草 模 块 描 述 符 (参见 9.3.2 节 )， 它 都 有 着 具体 的 应 用 。 

为 了 进一步 探寻 这 个 工具 , 我 鼓励 你 进行 实践 , 并 且 最 好 基于 一 个 你 自己 的 项 目 。 如 果 你 的 
项 目 中 有 一 个 JAR, 并 且 在 另 一 个 目录 中 存放 了 所 有 的 传递 依赖 , 那么 整个 过 程 将 非常 简单 。 如 
果 你 正在 使 用 Maven, 则 可 以 通过 maven-dependency-plugin 的 copy-dependencies 瞩 (goal ) 
实现 后 者 。 利 用 Gradle， 则 可 以 通过 copy 任务 将 from 设置 为 configurations .compile 或 
configurations.runtime。 可 以 利用 快速 搜索 查阅 这 些 细节 。 

我 选择 了 Scaffold Hunter 作为 我 的 样 例 项 目 : 


Scaffold Hunter 是 一 个 基于 Java 的 开源 工具 ， 它 通过 聚焦 于 生命 科学 所 产生 的 数据 
对 数据 集 进行 可 视 化 分 析 ， 意 在 直观 地 访问 庞大 上 且 复杂 的 数据 集 。 该 工具 提供 了 一 系列 
视图 ， 比 如 曲线 图 、 系 统 树 图 和 绘图 视图 ， 以 及 相关 的 分 析 方法 ， 比 如 集群 和 分 类 。 


我 下 载 了 2.6.3 版 本 的 Zip 文件 ， 并 将 所 有 依赖 复制 到 libs 目录 中 。 在 展示 输出 时 ， 为 了 让 
名 称 更 加 简洁 ， 我 将 包 名 和 文件 名 中 的 scaffoldhunter 缩写 为 sh。 













































































D.1 认识 JDeps 


来 认识 一 下 JDeps: 在 哪里 获取 它 、 如 何 得 到 第 一 次 结果 以 及 在 哪里 寻求 帮助 。 从 Java 8 开 
始 ， 你 可 以 在 JDK 的 bin 目录 中 找到 JDeps 的 可 执行 文件 jdeps。 如 果 它 在 命令 行 中 可 用 ， 则 会 
使 事情 变 得 非常 简单 ,但 这 要 求 你 对 所 使 用 的 操作 系统 做 一 些 设置 。 确保 jdeps --version 可 
以 正确 工作 ， 并 显示 你 正在 使 用 的 是 最 新 版 本 。 

下 一 步 是 选 定 一 个 JAR, 并 指定 JDeps 对 其 进行 分 析 。 如 果 没 有 进一步 的 命令 行 选 项 ， 它 会 
首先 列 出 代码 所 依赖 的 JDK 模 块 ,以 及 对 所 有 了 既 不 属于 该 JAR 又 不 属于 JDK 的 代码 的 not found 
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提示 。 接 下 来 是 一 个 以 Stfpackage】 -> Ss{package} ${mogdule/JAR} 为 形式 的 包 级 别 的 依赖 
列表 。 

调用 jdeps scaffold-hunter-2.6.3.jar 将 导致 如 下 的 大 量 输出 。 可 以 看 到 ，Scaffold 
Hunter 依赖 于 java.base 模块 、java.desktop 模块 ( 这 是 一 个 Swing 应 用 程序 )、java.sql 模块 ( 数据 
集 存储 在 SQL 数据 库 中 ) 以 及 一 些 其 他 模块 。 在 这 之 后 是 包 依赖 的 长 列表 ， 此 处 只 展示 了 其 中 
一 部 分 。 


$ jdeps scaffold-hunter-2.6.3.jar 





























# 记 住 ,，“sh” 是 “scaffold-hunter”( 对 于 文件 名 ) 和 “scaffoldhunter”( 对 于 包 名 ) 的 缩写 
> sh-2.6.3.jar -> java.base -> 
> sh-2.6.3.jar -> java.datatransfer i 
> sh-2.6.3.jar -> java.desktop 项 目 所 依赖 的 JDK 模块 
> sh-2.6.3.jar -> java.logging 
> sh-2.6.3.jar -> java.prefs 
> sh-2.6.3.jar -> java.sql 
> sh-2.6.3.jar -> java.xml a 
> > sh-2.6.3.jar -> not found 在 JAR 内 部 和 之 间 的 
= edu.udo.sh -> com.beust.jcommander not found 包 依赖 
> edu.udo.sh -> edu.udo.sh.data sh=2.683j8E 
> edu.udo.sh -> edu.udo.sh.gui sh-2.6.3.jar 
> edu.udo.sh -> edu.udo.sh.gui.util sh-2.6.3.jar 
2 edu.udo.sh -> edu.udo.sh.util sh-2.6.3.jar 
> edu.udo.sh -> java.io java.base 
> edu.udo.sh -> java.lang java.base 
> edu.udo.sh -> javax.swing java.desktop 
> > edu.udo.sh -> org.slf4j not found 
# 省 略 了 更 多 的 包 依 赖 
“not found” 暗 示 了 依赖 没有 被 找到 ， 
这 并 不 奇怪 ， 因 为 我 并 没有 告诉 
JDeps 在 哪里 寻找 它们 








现在 ， 是 时 候 用 不 同 的 选项 来 调整 输出 了 。 可 以 用 jaeps -h 列 出 这 些 选 项 。 


D.2 在 分 析 结 果 中 包含 依赖 


JDeps 的 一 个 重要 的 方面 是 它 允许 你 像 分 析 自 己 的 代码 一 样 分 析 依 赖 。 实 现 这 个 目 4 
步 是 通过 --class-patn 选项 将 它们 放置 到 类 路 径 中 。 但 是 这 仅 确 保 了 JDeps 将 路 径 延 伸 到 你 上 
依赖 JAR 中 ， 并 且 摆 脱 了 not foung 提示 。 为 了 能 同时 对 依赖 进行 分 析 ， 你 需要 让 和 
-recursive 或 -r 递归 进入 依赖 JAR。 

为 了 包含 Scaffold Hunter 的 依赖 ,我 用 --class-path '1ibs/*' 和 -recursive 执行 了 
JDeps， 接 下 来 就 可 以 看 到 结果 。 在 这 个 例子 中 ， 命 令 行 输出 以 一 些 包 分 裂 警 告 开头 ， 我 将 暂时 

忽略 它们 。 后 面 跟 着 的 模块 、JAR 和 包 依 赖 和 以 前 一 样 ， 但 是 现在 已 经 完整 了 ， 所 以 这 个 列表 相 
当 长 。 
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大 VV VV VVV VYV 站 V VV VVVV VV VV VV V VV 大 





jdeps -recursive 
--cCclass-path 
scaffold-hunter-2.6.3.jar 








省 略 了 
省 略 了 一 些 
-> 
SN-2 673]ar ‘se% 
sh-2.6.3.jar -> 
sh-2.6.3.jar -> 
Sn-=26.35jar' => 
sh-2.6.3.jar -> 
Sh -26.3 jar .=> 
S027.673.ar -=> 
Sh-2..6.3 ja => 
Sh 6..3. 5]ar = 
Sh=2.6,3..jar 一 > 
SHE=226.2339 az 一 
sh-2.6.3.jar -> 
= 人 有 己基 = 
sh-2.6.3,.jar -> 
Sh=2.6..3% jr “=> 
省 略 了 更 多 的 模块 或 
edu.udo.sh 
edu.udo.sh 
edu.udo.sh 
edu.udo.sh 
edu.udo.sh 
edu.udo.sh 
edu.udo.sh 
edu.udo.sh 
edu.udo.sh 





DSA 


libs/commons-codec-1.6.jar 
libs/commons-io-2.4.jar 
libs/dom4j-1.6.1.jar 
libs/exp4j-0.1.38.jar 
libs/guava-18.0.jar 
libs/heaps-2.0.jar 


ava.base 
ava.datatransfer 
ava.desktop 





Els 议定 


java.logging 
java.prefs 
java.sqgl 
java.xml | 不 再 有 “not found” 
libs/javassist-3.18.1-GA.jar 的 包 依赖 源 
libs/jcommander-1.35.jar A 
JAR 依赖 
-> com.beust.jcommander jcommander-1.35.jar 可 -四 
-> edu.udo.sh.data sh-2756.3;:jar 
-> edu.udo.sh.gui sh-2.6.3.jar 
-> edu.udo.sh.gui.util sh-2.6.3.jar 
-> edu.udo.sh.util Sh-2..6,3jar 
-> java.io java.base 
-> java.lang java.base 
-> javax.swing java.desktop 
-> org.slf4j slf4j-api-1.7.5.jar OC 


省 略 了 更 多 更 多 的 包 依 赖 


这 使 得 输出 完全 被 淹没 ， 所 以 你 需要 立即 想 办 法 从 如 此 多 的 数据 中 提取 出 有 意义 的 信息 。 


D.3 配置 JDeps 的 输出 


依赖 的 -summary 或 -<s， 如 下 所 示 。 


$ jdeps -summary -recursive 
--Class-path 
scaffold-hunter-2.6.3.jar 


A A A 


省 略 了 包 


分 裂 警告 


"Tibs/x， 


省 略 了 一 些 模块 或 JAR 依赖 


Sh-2 . 
sh-2. 
sh-2. 
sh-2. 
sh-2. 


Loe) 


Om 
OO 


.jar -> 
.jar -> 
.jar -> 
.jar -> 
jar => 


libs/javassist-3.18.1-GA.jar 
libs/jcommander-1.35.jar 
libs/jgoodies-forms-1.4.1.jar 
libs/jspf.core-1.0.2.jar 
libs/12fprod-common-sheet .jar 


不 再 有 “not found” 
的 JAR 依赖 


libs/hibernate-core-4.3.6.Final.jar 

















配置 JDeps 的 输出 有 很 多 方法 。 在 首次 分 析 茶 个 项 目 时 , 也 许 最 好 的 选项 是 仅 展 示 JAR 之 间 
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> sh-2.6.3.jar -> libs/l12fprod-common-tasks.jar 

> sh-2.6.3.jar -> libs/opencsv-2.3.jar 

> sh-2.6.3.jar -> libs/piccolo2d-core-1.3.2.jar 

> sh-2.6.3.jar -> libs/piccolo2d-extras-1.3.2.jar 

> sh-2.6.3.jar -> libs/slf4j-api-1.7.5.jar 

> sh-2.6.3.jar -> libs/xml-apis-ext.jar 

Ss Sh-2.6.3.jar’ ->. TiDs/xstream-1..4.1..jar 

> slf4j-api-1.7.5.jar -> java.base 

> slf4j-api-1.7.5.jar -> libs/slf4j-jdk14-1.7.5.jar 
> slf4j-jdk14-1.7.5.jar -> java.base 

> slf4j-jdk14-1.7.5.jar -> java.logging 

> slf4j-jdk14-1.7.5.jar -> libs/slf4j-api-1.7.5.jar 
# 省 略 了 更 多 的 模块 或 JAR 依赖 


表 D-1 列举 了 用 于 分 析 依 赖 的 不 同方 面 的 多 种 筛选 方式 。 


表 D-1 对 筛选 JDeps 输出 的 部 分 选项 进行 简短 的 描述 










































































选 项 描 ” 述 

--api-only 或 -apionly 在 某 些 情况 下 ， 尤 其 是 在 分 析 类 库 时 ， 你 仅 关心 某 个 JAR 的 API。 利 用 这 个 选项 ， 
只 有 公有 类 的 公有 或 受 保护 的 成 员 中 所 提 及 的 类 型 才 会 被 检查 

-filter 或 -f 紧 跟 一 个 正则 表达 式 ， 排 除 对 满足 正则 表达 式 的 类 的 依赖 〈 注意， 除非 使 用 了 
-verbose:class， 和 否则 输出 仍然 会 显示 包 ) 

-filter:archive 在 很 多 情况 下 ,在 工件 内 部 的 依赖 不 是 那么 值得 关注 。 这 个 选项 将 它们 忽略 , 仅 展 
示 工 件 之 间 的 依赖 

--package 或 -p 紧 跟 一 个 包 名 ， 仅 考虑 对 该 包 的 依赖 ， 对 于 查看 使 用 utils 的 所 有 位 置 来 说 是 一 
个 很 好 的 途径 


--regex 或 -e 











紧 跟 一 个 正则 表达 式 ， 仅 考虑 对 满足 正则 表达 式 的 类 的 依赖 〈 注 意 ， 除 非 使 用 了 











-verbose:class， 和 否则 输出 仍然 会 显示 包 ) 








命令 行 输出 是 检查 细节 和 深入 研究 的 一 个 有 效 途 径 , 即便 它 不 是 用 于 直观 的 概览 (图表 更 加 
胜任 于 此 )。 幸 运 的 是 ，JDeps 拥有 - -dot-output 选项 ， 可 以 为 每 个 单独 的 分 析 创 建 .dot 文件 。 
这 些 文件 是 纯 文本 的 , 一 些 其 他 的 工具 ， 比 如 Graphviz， 可 以 用 来 基于 这 些 文件 创建 镜像 。 具 体 
示例 参见 代码 清单 D-1 和 图 D-1。 

















代码 清单 D-1 

















将 工件 依赖 可 视 化 





$ jdeps -recursive 通过 指定 --dot-output dots 让 JDeps 
--class-path 'libs/*' 在 dots 目录 中 创建 .dot 文 件 
--dot-output dots 2 
壮 合 公 
scaffold-hunter-2.6.3.jar Graphviz 提供 了 dot 命令 ， 在 此 用 来 在 


$ dot -Tpng -0O dqots/summary .dqot 


dots 目录 中 创建 一 个 summary.dot.png 
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4 一 这 边 有 更 多 依赖 这 边 也 是 一 上 


scaffold-hunter 























piccolo2d-extras, jspf.core 12fprod-common-sheet 


1/ piccolo2d-core java datatransfer opencsv 12fprod-common-tasks 
xstrear 





















































图 D-1 代码 清单 D-1 的 结果 是 一 个 巨大 的 、 复 杂 的 但 仍然 有 迹 可 循 的 依赖 关系 图 。 这 只 是 一 个 
精简 过 的 部 分 。 不 要 担心 细节 ， 而 是 为 你 的 项 目 创建 一 个 同样 的 依赖 关系 图 











Dot 文件 与 Graphviz 

.dot 文件 是 纯 文 本 文件 ， 同 时 是 一 个 很 好 的 可 编辑 的 所 见 即 所 得 的 文件 。 利 用 一 些 正则 表 
达 式 ,你 可 以 从 底部 删除 java.base 模块 ( 让 模块 图 更 加 简化 ), 或 者 从 JAR 名 称 中 删除 版 本 ( 让 
图 更 加 精简 )。 关 于 Graphviz 的 更 多 信息 ， 参 见 其 官方 网 站 。 


D.4 深入 探寻 项 目的 依赖 


如 果 你 想见 到 更 多 的 细节 ，-verbose:class 可 以 列 出 类 间 依 赖 ， 而 非 将 它们 聚合 到 包 级 
别 。 有 些 情况 下 仅 列 出 对 某 个 包 或 类 的 直接 依赖 是 不 够 的 ， 因 为 它们 可 能 存在 于 依赖 中 ， 而 不 是 
在 你 的 代码 中 。 在 这 样 的 情况 下 , --inverse 或 -I 也 许 会 有 帮助 。 指定 某 一 个 包 或 正则 表达 式 ， 
它 将 尽 可 能 地 跟踪 这 些 依赖 ,进而 将 相关 工件 列 出 。 不幸 的 是 , 没有 直观 的 方法 可 以 查看 类 级 别 
的 结果 ， 而 只 能 查看 工件 级 别 的 结 

如 果 你 仅 对 被 某 个 类 库 的 公有 API 所 公开 的 依赖 感 兴趣 ， 则 可 以 使 用 --api-only。 利 用 
这 个 选项 ， 只 有 公有 类 的 公有 或 者 受 保护 成 员 中 所 提 及 的 类 型 会 被 检查 。 除 此 之 外 ， 还 有 一 些 
其 他 的 选项 可 以 针对 你 的 具体 用 例 提供 帮助 一 一 正如 前 面 提 到 的 , 你 可 以 通过 jdeps -h 列 出 这 
些 选 项 。 











D.5 ”JDeps 理 解 模块 


如 同 编译 器 和 JVM 可 以 在 更 高 的 抽象 级 别 中 运转 一 样 , 得 益 于 模块 系统 ,JDeps 也 可 以 。 模 
块 路 径 可 以 通过 --module-path ( 注意 ，-p 是 被 保留 的 : 它 不 是 这 个 选项 的 简写 ) 来 指定 , 初 
始 模 块 则 可 以 通过 --module 或 -m 来 指定 。 于 是 ， 你 可 以 像 先 前 一 样 进行 同样 的 分 析 。 
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jdeps -summary -recursive 
--module-path mods:libs 


-m monitor 





丰 VV VV VV VV VVV VVV VVV VVV VVV VVV Vv VV Vv VV 椒 


On tO 
monitor. 
monitor. 
monitor. 
monitor. 
monitor. 


monitor. 


monitor -> 
monitor -> 
moOniteor = 
monitor -> 
monitor -> 
monitor -> 
monitor. 


省 略 了 一 些 模块 依赖 


monitor -> 


java.base 
monitor.observer 
monitor.observer.alpha 
monitor.observer.beta 
monitor.persistence 
monitor.rest 
monitor.statistics 


observer -> java.base 
observer.alpha -> java.base 
observer.alpha -> monitor.observer 
observer.beta -> java.base 
observer.beta -> monitor.observer 
persistence -> java.base 
persistence -> monitor.statistics 
persistence -> hibernate.jpa 


monitor. 

monitor.rest -> java.base 
monitor.rest -> monitor.statistics 
monitor.rest -> spark.core 


statistics -> java.base 


monitor.statistics -> monitor.observer 
slf4j.api -> java.base 

slf4j.api -> not found 

spark.core -> JDK removed internal API 
spark.core -> java.base 

spark.core -> javax.servlet.api 
spark.core -> jetty.server 

spark.core -> jetty.servilet 

spark.core -> jetty.util 

spark.core -> slf4j.api 

spark.core -> websocket.api 

spark.core -> websocket .server 
spark.core -> websocket .servilet 

省 略 了 更 多 的 模块 依赖 


除 此 之 外 ， 还 有 一 些 Java9 和 模块 相关 的 选项 。 通 过 --requires $ {modules} 选 项 ， 你 可 
以 列 出 所 有 依赖 特定 模块 的 模块 ,7.1.2 节 曾 阐述 过 如 何 使 用 --jqk-internals 分 析 项 目的 问题 


依赖 。9.3.2 节 解 释 


和 过 如 何 使 用 --generate-module-info 和 --generate-open-module 起 草 





模块 描述 符 。 如 前 所 述 ，JDeps 也 将 始终 会 报告 它 找到 的 所 有 包 分 裂 一 一 该 问题 已 经 在 7.2 方 中 


详细 讨论 过 。 

















一 个 有 趣 的 选项 是 --check， 该 选项 为 模块 的 描述 符 提 供 了 不 同 的 视角 ( 如 图 D-2 所 示 )。 








口 它 从 打印 真实 的 描述 符 开始 ， 接 着 是 两 个 假想 的 描述 符 。 
口 第 一 个 假想 的 描述 符 被 称 作 建 议 描述 符 ， 其 声明 了 对 所 有 模块 的 依赖 一 一 仅 当 某 个 模块 


包含 类 型 在 被 检查 的 模块 中 使 用 。 





342 附录 D 利用 JDeps 分 析 项 目的 依赖 





口 第 二 个 假想 的 描述 符 被 称 作 传递 简化 图 (transitive reduced graph ),， 其 
似 ,但 是 删除 了 由 于 隐 式 可 读 性 而 可 被 读 取 的 依赖 (参见 9.1 节 )。 这 
建 可 靠 配置 的 最 小 依赖 集合 。 
最 终 ， 如 果 模 块 声明 了 任何 合 规 导出 (参见 9.3 前 ，--check 将 输出 那些 在 可 见 模块 全 
局 中 尚未 使 用 的 导出 。 
--check 所 创建 的 假想 描述 符 也 可 以 通过 --1ist-deps 和 --1ist-reduced-deps 选项 分 
别 查 看 。 它 们 也 可 以 在 类 路 径 上 工作 ， 只 是 因此 会 引用 无 名 模块 ( 参见 8.2 区 。 


jdeps --module-path mods:libs --check monitor.peek 


monitor.peek monitor.peek (file:///../mods/monitor.peek.jar) 
[Module descriptor] 


requires mandated java.base (@9.0.4); 
requires monitor.observer.alpha; 
requires monitor.persistence; 


monitor. monitor. 间接 的 monitor. requires monitor.statistics; 
observer.alpha persistence statistics [Suggested module descriptor for monitor.peek] 
requires mandated java.base; 
间接 的 requires monitor.observer; 


requires monitor.observer.alpha; 
间接 的 requires monitor.persistence; 


monitor. [Transitive reduced graph for monitor.peek] 
observer requires mandated java.base; 


requires monitor.observer.alpha; 
requires monitor.persistence; 


图 D-2 在 左 侧 ， 可 以 看 到 monitor.peek ( 参见 11.1.1 节 ) 和 它 的 传递 依赖 ， 其 中 有 些 对 其 他 模块 
隐 式 可 读 。 在 右 侧 ,JDeps 建议 在 依赖 列表 中 包含 monitor.observer ( 因为 它 的 类 型 被 直接 
引用 ) 。 此外, 它 列 出 了 monitor.peek 充分 利用 了 隐 式 可 读 性 而 所 依赖 的 模块 的 最 小 集合 





与 前 一 个 描述 符 相 
意味 着 它 是 可 以 创 








































































通过 多 发 行 版 JAR 支 持 
多 个 Java 版 本 








决定 项 目 依赖 哪个 Java 版 本 从 来 不 是 一 件 容易 的 事情 。 一 方面 ， 你 想 给 用 户 选 择 的 自由 ， 
因此 最 好 支持 多 个 主要 版 本 ， 而 不 仅仅 是 最 新 版 本 。 另 一 方面 ， 你 渴望 使 用 最 新 的 语言 特性 和 
API。 从 Java 9 开始, 一 个 新 的 JVM 功能 ， 即 多 发 行 版 JAR,， 可 以 帮助 你 调和 这 些 对 立 面 一 一 至 
少 在 某 些 情况 下 可 以 做 到 。 

多 发 行 版 JAR 允许 在 同一 工件 中 发 布 针对 不 同 Java 版 本 的 字 节 码 。 然 后 ， 你 可 以 基于 JVM 
来 加 载 针 对 其 支持 的 最 新 版 本 编译 的 类 。 从 在 最 低 支 持 的 Java 版 本 上 成 功 运行 的 项 目 开 始 ， 通 
过 使 用 更 具 弹 性 和 更 好 性 能 的 API， 你 可 以 有 选择 地 在 较 新 的 JVM 上 进行 改进 ， 而 不 必 强 求 提 
高 项 目的 基线 (baseline )。 
要 点 当然， 只 有 在 你 无 法 完全 控制 运行 项 目的 JVM 版 本 时 ， 才 需要 考虑 多 发 
行 版 JAR。 对 于 类 库 和 框架 ， 通 常 是 这 样 。 而 对 于 用 户 自己 托管 的 桌面 应 用 程序 
或 Web 后 端 程序 ,通常 也 是 这 样 。 另 一 方面 ， 如 果 你 自行 管理 运行 应 用 程序 的 服 
务 器 , 则 可 以 自行 控制 使 用 较 新 的 JVM, 并 不 需要 考虑 使 用 复杂 的 多 发 行 版 JAR，。 

所 有 这 些 都 解决 后 ， 让 我 们 深入 看 看 这 个 方便 的 新 特性 。 我 们 会 先 创 建 一 个 简单 的 发 行 版 
JAR， 然 后 研究 其 内 部 结构 ， 最 后 再 针对 何 时 以 及 如 何 使 用 发 行 版 JAR 提出 一 些 建议 。 


E.1 创建 多 发 行 版 JAR 


















































定义 
多 发 行 版 JAR 是 专门 准备 的 JAR， 其 中 包含 为 几 个 主要 Java 版 本 准备 的 字 节 码 。 字 节 码 
如 何 加 载 取决 于 JVM 的 版 本 。 
口 Java 8 及 更 早 版 本 加 载 非 版 本 相关 (version-unspecific ) 的 类 文件 。 
口 Java9 及 以 上 版 本 加 载 版 本 相关 (version-specific ) 的 类 文件 ( 如 果 存 在 的 话 )， 否 则 回 
退 到 加 载 非 版 本 相关 的 类 文件 。 


PR 
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要 准备 一 个 多 发 行 版 JAR， 你 需要 按 所 针对 的 Java 版 本 来 分 割 源 文件 ， 为 不 同 的 版 本 编译 
一 组 不 同 的 源 文件 ， 并 将 生成 的 .class 文件 放 在 各 自 的 目录 中 。 当 使 用 jar 将 它们 打包 时 ， 你 照 
常 添加 基线 类 文件 ( 直接 添加 或 使 用 -c 参数 ， 参 见 4.5.1 节 )， 并 对 每 个 不 同 的 字 节 码 集合 使 用 
新 的 选项 --release ${release}。 

下 面 来 看 一 个 例子 。 假 设 你 需要 检测 当前 正在 运行 的 JVM 的 主 版 本 。Java 9 为 此 提供 了 
一 个 不 错 的 API， 因 此 你 不 再 需要 解析 系统 属性 了 ( 6.5.1 节 对 此 进行 了 概述 ， 不 过 其 中 的 细 
节 在 此 并 不 重要 )。 通 过 部 署 一 个 多 发 行 版 JAR， 如 果 在 Java 9 及 以 上 版 本 中 运行 ,你 可 以 使 
用 其 API。 

假设 该 应 用 程序 有 两 个 类 , 即 Main 和 Detectversion, 并 且 目 标 是 拥有 DetectVersion 
的 两 个 变 体 ， 一 个 用 于 Java 8 及 更 早 版 本 ， 另 一 个 用 于 Java 9 及 以 上 版 本 。 这 两 个 变 体 必 须 具 有 
完全 相同 的 完全 限定 名 称 ( 在 IDE 中 同时 使 用 它们 具有 一 定 的 挑战 性 ) 一 一 并 且 假 设 将 它们 放 在 
两 个 并 行 的 源 目录 中 : src/main/java 和 src/main/java-9。 

图 E-1 展示 了 如 何 组 织 源 代码 ,代码 清单 E-1 展示 了 如 何 将 它们 编译 并 打包 至 一 个 多 发 行 
JAR 中 。 请 注意 这 两 个 编译 步 又 和 各 自 的 输出 目录 。 最 终结 果 如 图 E-2 所 示 。 


代码 清单 E-1 为 不 同 的 Java 版 本 编译 和 打包 源 文件 ， 并 生成 至 同一 个 JAR 













































































为 Java 8( 或 更 早 版 本 ) 编 译 src/main/java 为 Java 9 编译 src/main/java-9 中 的 代码 
中 的 代码 并 生成 至 classes 文件 夹 并 生成 至 classes-9 文件 夹 
javac --release 8 


-d classes 
src/main/java/org/codefx/detect/*.java 
javac --release 9 -十 
-d classes-9 
src/main/java-9/module-info.java 
src/main/java-9/org/codefx/detect/DetectVersion.java 





在 打包 字 节 码 至 JAR 时 , 像 往 
常 一 样 打 包 classes 中 默认 








jar --create | 的 字 节 码 
--file target/detect.jar 2 
-C classes . 包含 为 Java 9 特地 准备 的 
--release 9 类 文件 


-C classes-9 . | 
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国 module-info.java rs 于 使 用 了 较 
运行 会 失 见 
针对 Java 9 的 代码 放 在 src/main/ 运行 会 失败 ) 


java-9 中 平行 的 树 状 结构 中 
图 E-1 放置 多 发 行 版 JAR 源 代码 的 一 种 可 能 方法 。 最 重要 的 细节 是 ， 版 本 相关 的 代码 


和 你 想 作 为 默认 情况 运行 
的 类 放 在 src/main/java 
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又 供 娱乐 ， 我 们 也 为 Java 9 添加 
一 个 模块 描述 符 





























(这 里 为 DetectVersion ) 在 所 有 变 体 中 都 具有 相同 的 完全 限定 名 称 


这 个 简单 的 示例 创建 了 Detectversion 的 两 个 变 体 ， 
另 一 个 变 体 用 于 支持 Java 9。 通常 情况 下 实现 一 个 包含 多 个 类 、 支 持 多 个 Java 版 本 的 特性 是 非常 
里 就 不 介绍 形式 化 的 标准 版 本 了 。 作 为 替代 ，E.3 节 介 绍 了 一 些 经 验 。 


复杂 和 烦琐 的 ， 因 此 这 
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在 Java 8 及 更 早 版 本 中 加 载 

















于 可 选 信息 





JVM 会 查看 META- 
INF/versions 中 的 字 节 码 


该 版 本 的 petectVersion 将 
在 Java 9 及 六 上 版 本 中 加 载 





年 module-info.class 


一 一 一 模块 描述 符 只 会 在 Java 9 及 以 上 版 本 中 加 载 


E-2 ”代码 清单 E-1 生成 的 JAR 


一 个 变 体 用 于 支持 Java 8 及 更 早 版 本 ， 
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E.2 ”多 发 行 版 JAR 的 内 部 工作 机 制 


多 发 行 版 JAR 是 如 何 工作 的 ? 这 很 简单 : 它 将 非 版 本 相关 的 类 文件 存储 在 其 根 目 录 上 ( 像 
往常 一 样 )， 而 将 版 本 相关 的 文件 存储 在 META-INF/versions/$ {version} 中 。 





岂 























A 要 点 Java8 及 更 早 版 本 的 JVM 对 META-INF/versions 中 的 内 容 一 无 所 知 ， 并 从 


JAR 根 目录 里 的 包 结 构 中 加 载 类 。 因 此 ,无 法 详细 区 分 Java9 之 前 的 各 个 版 本 。 


但 是 ,新 的 JVM 首先 会 查看 META-INF/versions 中 的 内 容 ,， 并 且 只 在 它们 未 在 此 
处 找到 类 的 情况 下 才 会 查看 JAR 根 目录 。 它们 从 自己 的 版 本 开始 向 后 搜索 ,这 意 
味 着 Java 10 的 JVM 会 先 在 META-INF/versions/10 中 搜索 ， 然 后 是 META-INF/ 
Versions/9， 接 着 才 是 根 目录 。 因 此 这 些 JVM 可 以 用 它们 支持 的 最 新 版 本 相关 的 
类 文件 覆盖 根 目录 上 对 应 的 非 版 本 相关 的 类 文件 。 








除了 META-INF/versions 中 的 目录 外 ， 还 可 以 通过 查看 纯 文 本 文件 META-INF/MANIFEST.MF 
来 识别 多 发 行 版 JAR: 如 果 是 多 发 行 版 JAR， 则 该 清单 中 包含 条 目 Multi-Release: true。 


E.3 ”使 用 建议 


既然 你 已 

















经 知道 如 何 创建 多 发 行 版 JAR 以 及 它们 的 工作 原理 ,那么 为 了 帮助 你 充分 利用 它 











们 ， 我 想 提供 一 些 建议 。 更 准确 地 说 ， 我 会 为 以 下 主题 提供 提示 。 








口 如 何 组 织 源 代 码 








E.3.1 








口 如 何 组 织 字 节 码 
口 何 时 使 用 多 发 行 版 JAR 


组 织 源 代码 





口 支持 的 最 早 Java 版 本 的 代码 位 于 项 目的 默认 根 目 录 ( 比如 src/main/java， 而 不 

是 src/main/java-X ) 中 。 

口 该 源 目录 中 的 代码 是 完整 的 ， 这 意味 着 可 以 直接 编译 、 测 试 和 部 署 它们 ， 而 无 
须 来 自 版 本 相关 的 源 代 码 树 〈 比 如 src/main/java-X ) 中 的 其 他 额外 文件 ( 请 注 
意 , 如 果 你 提供 的 功能 仅 适用 于 Java 的 较 新 版 本 , 则 在 旧版 本 中 该 类 仅 需 抛 出 
错误 说 明 operation not supported before Java X 即 可 。 我 建议 你 不 
要 不 管 它 ， 以 免 导 致 无 意义 的 NoClassDefFoundError )。 








这 些 不 是 技术 要 求 。 没 有 什么 可 以 阻止 你 将 针对 Java 11 的 代码 一 半 放 在 src/main/java 中 ， 
一 半 ， 甚 至 全 部 ， 放 在 sre/main/java-11 中 。 但 是 这 只 会 引起 不 必要 的 混乱 。 
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通过 遵循 这 些 准 则 ,， 可 以 使 源 代 码 树 的 布局 尽 可 能 地 简单 。 查 看 它 的 任何 人 或 者 工具 ,都 可 
以 很 容易 地 发 现 针 对 所 需 JVM 版 本 的 功能 齐全 的 项 目 。 然 后 ， 与 版 本 相关 的 源 代 码 树 会 选择 性 
地 增加 需要 的 代码 以 支持 较 新 的 版 本 。 
如 何 验证 最 终 得 到 的 是 否 正确 ? 正如 我 之 前 所 说 , 形式 化 的 描述 很 复杂 , 所 以 此 处 是 我 的 经 
验 法 则 。 为 了 确定 你 的 特定 布局 是 否 有 效 ， 请 在 思想 上 (或 实际 上 ) 执行 以 下 步 又 。 
(1) 在 支持 的 最 早 的 Java 版 本 上 编译 和 测试 与 版 本 无 关 的 源 代 码 树 。 
(2) 对 于 其 他 每 个 源 代码 树 ， 执 行 以 下 操作 。 
a. 将 版 本 相关 的 代码 移 至 版 本 无 关 的 源 代码 树 中 ， 替 换 其 中 具有 完全 相同 完全 限定 名 称 
的 文件 。 
b. 在 较 新 版 本 上 编译 并 测试 源 代码 树 。 
如 果 能 正常 工作 ， 那 么 恭喜 你 。 
当然 ,你 的 工具 还 必须 支持 你 选择 的 源 代码 布局 。 不 垃 的 是 ,在 撰写 本 文 时 ，IDE 和 大 多 数 
构建 工具 对 此 布局 并 没有 很 好 的 支持 ， 因 此 你 可 能 不 得 不 受 协 。 作 为 替代 解决 方案 , 请 考虑 为 每 
个 Java 版 本 创建 单独 的 项 目 。 






























































E.3.2 组织 字 节 码 


要 点 ”从 上 述 源 代码 树 结构 到 如 何在 JAR 中 组 织 字 节 码 的 建议 , 这 一 过 程 的 直接 
路 线 如 下 o 


口 支持 的 最 早 Java 版 本 上 的 字 节 码 直 接 进 入 JAR 的 根 目录 中 ， 这 意味 着 它 不 会 
通过 --release 选项 添加 。 

口 JAR 根 目 录 中 的 字 节 码 是 完整 的 ， 这 意味 着 它 可 以 直接 执行 ， 而 无 须 来 自 
META-INF /versions 中 的 其 他 文件 。 


再 一 次 ， 这 些 都 不 是 技术 要 求 ， 但 它们 保证 了 每 个 查看 JAR 根 目 录 的 人 都 可 以 看 到 针对 所 
需 JVM 版 本 编译 的 功能 齐全 的 项 目 ， 并 且 可 以 通过 META-INF/versions 针对 较 新 的 JVM 进行 选 
择 性 的 增强 。 


E.3.3” 何 时 使 用 多 发 行 版 JAR 


多 发 行 版 JAR 如 何 帮 助 你 解决 选择 所 依赖 Java 版 本 的 困境 ?首先 要 明确 的 是 ， 准 备 使 用 多 
发 行 版 JAR 会 增加 很 多 的 复杂 性 。 
口 必须 正确 配置 IDE 和 构建 工具 ， 以 能 够 更 轻松 地 处 理 多 个 针对 不 同 Java 版 本 编译 的 具有 
完全 相同 完全 限定 名 称 的 源 文 件 。 
口 需要 让 同一 源 文件 的 多 个 变 体 保持 同步 ， 以 便 保持 相同 的 公有 API。 
口 单元 测试 变 得 更 加 复杂 ,因为 你 可 能 最 终 编 写 了 只 能 运行 在 特定 JVM 版 本 中 的 测试 文件 。 
D 集成 测试 变 得 更 加 麻烦 ， 因 为 需要 考虑 在 多 发 行 版 JAR 包含 字 节 人 码 的 每 个 Java 版 本 中 测 

试 所 产生 的 工件 。 
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要 点 ”这 意味 着 你 应 该 仔细 考虑 是 否 要 创建 多 发 行 版 JAR。 走 这 条 路 应 该 有 可 观 
的 回报 (至 少 可 以 提高 所 需 的 Java 版 本 )。 








此 外 ， 多 发 行 版 JAR 也 不 适合 使 用 为 便捷 性 而 设计 的 新 语言 特性 。 如 你 所 见 ， 所 涉及 的 源 
文件 需要 有 两 个 变 体 , 如 果 你 必须 为 不 便捷 的 变 体 保留 一 份 源 文件 , 那么 这 些 所 谓 的 便捷 性 无 法 
带 来 任何 便利 。 语 言 特性 也 将 很 快 渗透 到 代码 类 库 中 ,从 而 导致 大 量 重复 的 类 。 所 以 这 不 是 一 个 
好 主意 。 

另 一 方面 ，API 是 多 发 行 版 JAR 的 最 佳 选 择 。Java 9 引入 了 许多 新 的 API， 这 些 API 以 更 大 
的 弹性 和 更 好 的 性 能 解决 了 现 有 的 用 例 。 

口 使 用 Runtime .Version 而 不 是 解析 系统 属性 来 检测 JVM 版 本 (参见 6.5.1 欧 。 

口 使 用 栈 审 核 ( stack-walking ) API 而 不 是 创建 Throwable 来 分 析 调 用 栈 ( 本 书 没有 涵盖 
该 API, 但 是 你 的 日 志 框 架 的 开发 人 员 已 经 在 使 用 它 了 )。 

口 用 变量 句柄 来 代替 反射 (参见 12.3.2 前 。 

如 果 要 在 较 新 的 Java 发 行 版 上 使 用 较 新 的 API, 你 要 做 的 就 是 将 对 它 的 直接 调用 封装 在 专用 
的 包装 器 类 中 ， 然 后 实现 它 的 两 种 变 体 : 一 种 使 用 旧 的 API， 另 一 种 使 用 新 的 API。 如 果 你 已 经 
接受 了 前 面 描述 中 的 那些 复杂 性 ， 那 么 相对 而 言 这 很 简单 。 















































深入 理解 java 模块 系统 


将 代码 打包 成 整洁 、 定 义 良好 的 单元 ， 会 使 交付 安 
全 可 人 靠 的 应 用 程序 变 得 更 加 容易 ， 而 Java 平台 模块 系 
统 ( JPMS ) 是 创建 这 种 代码 单元 的 语言 标准 。 通 过 模 
块 ， 你 可 以 严密 地 控制 JAR 的 交互 方式 ， 并 在 启动 时 轻 
松 识 别 任何 依赖 缺失 。 这 种 设计 上 的 转变 非常 重要 ， 以 
至 于 从 Java 9 开始 ， 所 有 核心 Java APIl 都 以 模块 的 形 
式 来 分 发 ， 库 、 框 架 和 应 用 程序 也 将 从 中 受益 。 


本 书 是 创建 和 使 用 Java 模 块 的 指南 。 书 中 通过 具 
体 的 例子 和 通俗 易 懂 的 图 表 ， 剖 析 了 模块 化 Java 应 用 
程序 ， 阐 释 了 设计 模块 、 调 试 模块 化 应 用 程序 以 及 将 其 
部 署 到 生产 环境 的 操作 实践 。 读 者 不 仅 会 深入 理解 模块 
系统 ， 还 能 进一步 理解 Java 生 态 系统 。 


@ 剖析 模块 化 Java 应 用 程序 

@ 构建 模块 一 一 从 源 代码 到 JAR 
@ 迁移 到 模块 化 Java 

@ 解 耦 依赖 以 及 改进 API 

@ 处 理 反射 和 版 本 

@ 自 定义 运行 时 镜像 


丑 国 MANNING 


图 灵 社 区 : iTuring.cn 
分 类 建议 : 计算 机 / 程序 设计 / Java 
人 民 邮 电 出 版 社 网 址 : www.ptpress.com.cn 


“这 本 书 非常 全 面 地 介绍 了 模 
块 ， 尤 其 是 Java 11 的 模块 。” 


一 一 Mikkel Arentoft 
Danske Bank 


“这 本 书 对 人 们 盼望 已 久 的 
Java 模 块 系统 做 了 清晰 且 简 明 的 
介绍 。 9 


一 一 Jim Wright 
Sword Apak 


“如 果 你 想 认 真 学 习 Java 11， 
那么 你 将 需要 这 本 书 ! ” 


一 一 Christian Kreutzer-Beck 
ARAG ltaly 
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